IFunctionDiscovery::GetInstance 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 specified function instance, based on identifier.
Syntax
HRESULT GetInstance(
[in] const WCHAR *pszFunctionInstanceIdentity,
[out] IFunctionInstance **ppIFunctionInstance
);
Parameters
[in] pszFunctionInstanceIdentity
The identifier of the function instance (see GetID).
[out] ppIFunctionInstance
A pointer to an IFunctionInstance interface pointer used to return the interface.
Return value
Possible return values include, but are not limited to, the following.
Return code/value | Description |
---|---|
|
The method completed successfully. |
|
The value of pszFunctionInstanceIdentity is invalid. |
|
The method is unable to allocate the memory required to perform this operation. |
|
The function instance represented by the specified ID does not exist on this computer. |
|
The call was executed for a provider that returns results asynchronously. |
Remarks
Some function discovery providers return their query results with the IFunctionDiscoveryNotification interface. GetInstance does not find function instances that are returned in this way and will fail with E_PENDING. It is recommended that clients use the CreateInstanceQuery method of the IFunctionDiscovery interface to find function instances for such providers.
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 |