ddCatFindCat

ddCatFindCat( 
b_ddId 
t_name 
t_mode 
) 
=> b_objId / nil 

Description

Returns the ID of a category with the given name in the given mode. Traverses category hierarchies. This function calls ddCatOpen to get the category ID to be returned. The caller must call ddCatClose to properly flush the information from virtual memory when done. The category is opened in the given mode.

Arguments

b_ddId	ID of a category.
t_name	The category name.
t_mode	The modes "a", "w", or "r". For more information, see ddGetObj.

Value Returned

b_objId	The ID of a category with the given name in the given mode. The returned ID can be used to access the category members.
nil	The function failed.

Return to top