IFunctionInstance::GetCategory method (functiondiscoveryapi.h)
[Function Discovery is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]
Gets the category and subcategory strings for the function instance.
Syntax
HRESULT GetCategory(
[out] WCHAR **ppszCoMemCategory,
[out] WCHAR **ppszCoMemSubCategory
);
Parameters
[out] ppszCoMemCategory
The null-terminated identifier string of the category. See Category Definitions.
Be sure to free this buffer using CoTaskMemFree.
[out] ppszCoMemSubCategory
The null-terminated identifier string of the subcategory. See Subcategory Definitions.
Return value
Possible return values include, but are not limited to, the following.
Return code | Description |
---|---|
|
The method completed successfully. |
|
The method is unable to allocate the memory required to perform this operation. |
Remarks
The category and subcategory of a function instance always refer to the provider category from which a function instance comes.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2008 [desktop apps only] |
Target Platform | Windows |
Header | functiondiscoveryapi.h |
DLL | FunDisc.dll |