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
S_OK
The method completed successfully.
E_OUTOFMEMORY
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

See also

IFunctionInstance