通过

IFunctionDiscovery：：GetInstance 方法 (functiondiscoveryapi.h)

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

根据标识符获取指定的函数实例。

语法

HRESULT GetInstance(
  [in]  const WCHAR       *pszFunctionInstanceIdentity,
  [out] IFunctionInstance **ppIFunctionInstance
);

参数

[in] pszFunctionInstanceIdentity

函数实例的标识符 (请参阅 GetID) 。

[out] ppIFunctionInstance

指向用于返回接口 的 IFunctionInstance 接口指针的指针。

返回值

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

返回代码/值 说明
S_OK
 该方法已成功完成。
E_INVALIDARG
 pszFunctionInstanceIdentity 的值无效。
E_OUTOFMEMORY
 方法无法分配执行此操作所需的内存。
HRESULT_FROM_WIN32 (ERROR_OBJECT_NOT_FOUND)
0x800710d8
 此计算机上不存在由指定 ID 表示的函数实例。
E_PENDING
 调用针对异步返回结果的提供程序执行。

注解

某些函数发现提供程序使用 IFunctionDiscoveryNotification 接口返回其查询结果。 GetInstance 找不到以这种方式返回的函数实例，并且会失败并出现E_PENDING。 建议客户端使用 IFunctionDiscovery 接口的 CreateInstanceQuery 方法来查找此类提供程序的函数实例。

要求

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

另请参阅

IFunctionDiscovery

  • Last updated on