IFunctionDiscovery::CreateInstanceQuery 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.]

Creates a query for a specific function instance.


HRESULT CreateInstanceQuery(
  [in]      const WCHAR                    *pszFunctionInstanceIdentity,
  [in]      IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification,
  [in, out] FDQUERYCONTEXT                 *pfdqcQueryContext,
  [out]     IFunctionInstanceQuery         **ppIFunctionInstanceQuery


[in] pszFunctionInstanceIdentity

The identifier of the function instance.

[in] pIFunctionDiscoveryNotification

A pointer to the IFunctionDiscoveryNotification interface implemented by the calling application. If specified, it enables the Function Discovery change notification process. This parameter can be NULL; however it is required for network providers.

[in, out] pfdqcQueryContext

A pointer to the context in which the query was created. The type FDQUERYCONTEXT is defined as a DWORDLONG.

[out] ppIFunctionInstanceQuery

A pointer to an IFunctionInstanceQuery interface pointer used to return the generated query.

Return value

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

Return code Description
The method completed successfully.
ppIFunctionInstanceQuery is NULL.
The method is unable to allocate the memory required to perform this operation.


Function Discovery Network providers only return instances through the IFunctionDiscoveryNotification interface.

This method only initializes the query call. The Execute method of the IFunctionInstanceQuery interface returned in ppIFunctionInstanceQuery must be called to perform the query and return any data.


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

Function Discovery Queries