nf-functiondiscoveryapi-ifunctioninstance-getproviderinstanceid.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.GetProviderInstanceID	IFunctionInstance::GetProviderInstanceID (functiondiscoveryapi.h)	Gets the identifier string for the provider instance.	GetProviderInstanceID GetProviderInstanceID method GetProviderInstanceID method IFunctionInstance interface IFunctionInstance interface GetProviderInstanceID method IFunctionInstance.GetProviderInstanceID IFunctionInstance::GetProviderInstanceID functiondiscoveryapi/IFunctionInstance::GetProviderInstanceID ncd.ifunctioninstance_getproviderinstanceid_method	ncd\ifunctioninstance_getproviderinstanceid_method.htm	ncd	fad5e3f0-a440-4b09-ba8c-04bae2d14a2a	12/05/2018	GetProviderInstanceID, GetProviderInstanceID method, GetProviderInstanceID method,IFunctionInstance interface, IFunctionInstance interface,GetProviderInstanceID method, IFunctionInstance.GetProviderInstanceID, IFunctionInstance::GetProviderInstanceID, functiondiscoveryapi/IFunctionInstance::GetProviderInstanceID, ncd.ifunctioninstance_getproviderinstanceid_method	functiondiscoveryapi.h		Windows	Windows Vista [desktop apps only]	Windows Server 2008 [desktop apps only]					FunctionDiscoveryAPI.idl						FunDisc.dll		Windows			19H1	IFunctionInstance::GetProviderInstanceID functiondiscoveryapi/IFunctionInstance::GetProviderInstanceID	c++	APIRef kbSyntax	COM	FunDisc.dll	IFunctionInstance.GetProviderInstanceID

IFunctionInstance::GetProviderInstanceID

-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 identifier string for the provider instance. This string is the unique identifier for the provider instance.

-parameters

-param ppszCoMemProviderInstanceIdentity [out]

The provider instance identifier string. For root devices, this string has the same value as PKEY_PNPX_GlobalIdentity.

Be sure to free this buffer using CoTaskMemFree.

-returns

Possible return values include, but are not limited to, the following.

Return code	Description
S_OK	The method completed successfully.
E_INVALIDARG	The value of ppszCoMemProviderInstanceID is invalid.
E_OUTOFMEMORY	The method is unable to allocate the memory required to perform this operation.

-see-also

IFunctionInstance