IFunctionDiscovery：：CreateInstanceQuery 方法 (functiondiscoveryapi.h)

  • 项目

[函数发现可用于“要求”部分中指定的操作系统。 在后续版本中，它可能已更改或不可用。]

为特定函数实例创建查询。

语法

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

参数

[in] pszFunctionInstanceIdentity

函数实例的标识符。

[in] pIFunctionDiscoveryNotification

指向由调用应用程序实现的 IFunctionDiscoveryNotification 接口的指针。 如果指定，它将启用函数发现更改通知过程。 此参数可以为 NULL;但是，网络提供商需要它。

[in, out] pfdqcQueryContext

指向在其中创建查询的上下文的指针。 类型 FDQUERYCONTEXT 定义为 DWORDLONG。

[out] ppIFunctionInstanceQuery

指向 IFunctionInstanceQuery 接口指针的指针，用于返回生成的查询。

返回值

可能的返回值包括但不限于以下内容。

返回代码 说明
S_OK
 该方法已成功完成。
E_INVALIDARG
 ppIFunctionInstanceQuery 为 NULL。
E_OUTOFMEMORY
 方法无法分配执行此操作所需的内存。

注解

函数发现网络提供程序仅通过 IFunctionDiscoveryNotification 接口返回实例。

此方法仅初始化查询调用。 必须调用 ppIFunctionInstanceQuery 中返回的 IFunctionInstanceQuery 接口的 Execute 方法以执行查询并返回任何数据。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 functiondiscoveryapi.h
DLL FunDisc.dll

另请参阅

函数发现查询

IFunctionDiscovery