ICategory::get_ParentCategories
.gif "Ee810505.c++_off(en-US,CS.10).gif")
.gif "Ee810505.vb_on(en-US,CS.10).gif")
The ParentCategories property is a read-only recordset that contains the names of the parent categories of this category.
Definition
HRESULT ICategory::get_ParentCategories(_Recordset**ParentCategories);
Parameters
ParentCategories
[out, retval] A _Recordset object used to return the parent categories.
Return Values
This method returns an HRESULT indicating whether it completed successfully. See the Error Values section for more details.
Error Values
This method returns S_OK (0x00000000) to indicate success and standard COM HRESULT error values to indicate failure. For more information about standard COM errors, see Standard COM Errors. Additional information may be available using the global Err object, which can be accessed using the API function GetErrorInfo. In particular, the GetDescription method of the IErrorInfo interface may return a text description of the error.
Remarks
The ParentCategories parameter contains valid data only if the property is accessed successfully.
The ParentCategories property contains the names of the categories that are parent categories of this category. The recordset returned contains a single 128-character string column named Name, and one row for each parent that exists.
If this category is a root category, it has no parent categories, and an empty recordset is returned whose EOF property is set to VARIANT_TRUE.
See Also
ICategory::get_AncestorCategories