nf-functiondiscoveryapi-ifunctioninstance-getcategory.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:functiondiscoveryapi.IFunctionInstance.GetCategory	IFunctionInstance::GetCategory (functiondiscoveryapi.h)	Gets the category and subcategory strings for the function instance.	GetCategory GetCategory method GetCategory method IFunctionInstance interface IFunctionInstance interface GetCategory method IFunctionInstance.GetCategory IFunctionInstance::GetCategory functiondiscoveryapi/IFunctionInstance::GetCategory ncd.ifunctioninstance_getcategory_method	ncd\ifunctioninstance_getcategory_method.htm	ncd	dfb5f144-c9b0-455e-aff9-0c07225a21f6	12/05/2018	GetCategory, GetCategory method, GetCategory method,IFunctionInstance interface, IFunctionInstance interface,GetCategory method, IFunctionInstance.GetCategory, IFunctionInstance::GetCategory, functiondiscoveryapi/IFunctionInstance::GetCategory, ncd.ifunctioninstance_getcategory_method	functiondiscoveryapi.h		Windows	Windows Vista [desktop apps only]	Windows Server 2008 [desktop apps only]					FunctionDiscoveryAPI.idl						FunDisc.dll		Windows			19H1	IFunctionInstance::GetCategory functiondiscoveryapi/IFunctionInstance::GetCategory	c++	APIRef kbSyntax	COM	FunDisc.dll	IFunctionInstance.GetCategory

IFunctionInstance::GetCategory

-description

[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.

-parameters

-param ppszCoMemCategory [out]

The null-terminated identifier string of the category. See Category Definitions.

Be sure to free this buffer using CoTaskMemFree.

-param ppszCoMemSubCategory [out]

The null-terminated identifier string of the subcategory. See Subcategory Definitions.

-returns

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.

-see-also

IFunctionInstance