IFunctionInstance：：GetID 方法 (functiondiscoveryapi.h)

  • 项目

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

获取函数实例的标识符字符串。 可以保存此标识符，以后再用于通过 IFunctionDiscovery：：GetInstance 重新查询同一函数实例。

语法

HRESULT GetID(
  [out] WCHAR **ppszCoMemIdentity
);

参数

[out] ppszCoMemIdentity

函数实例标识符字符串。 此字符串的大小没有上限。

此字符串是由函数发现生成的组合字符串。 它将提供程序实例标识符字符串作为子字符串。 有关提供程序标识符的详细信息，请参阅 IFunctionInstance：：GetProviderInstanceID。

对于内置提供程序返回的函数实例，保证此标识符能够唯一标识系统上的资源，即使资源断开连接并重新连接也是如此。 对于自定义提供程序返回的函数实例，如果提供程序具有唯一的提供程序标识符，则函数实例标识符是唯一的。

不应以编程方式操作或制造此标识符。 字符串应仅用于检索函数实例，并用于比较目的。

请务必使用 CoTaskMemFree 释放此缓冲区。

返回值

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

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

要求

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

另请参阅

IFunctionInstance