[函数发现可用于“要求”部分中指定的操作系统。 它在后续版本中可能已更改或不可用。]
获取提供程序实例的标识符字符串。 此字符串是提供程序实例的唯一标识符。
语法
HRESULT GetProviderInstanceID(
[out] WCHAR **ppszCoMemProviderInstanceIdentity
);
参数
[out] ppszCoMemProviderInstanceIdentity
提供程序实例标识符字符串。 对于根设备，此字符串的值与 PKEY_PNPX_GlobalIdentity 相同。
请务必使用 CoTaskMemFree 释放此缓冲区。
返回值
可能的返回值包括但不限于以下值。
| 返回代码 | 说明 |
|---|---|
|
该方法已成功完成。 |
|
ppszCoMemProviderInstanceID 的值无效。 |
|
方法无法分配执行此操作所需的内存。 |
要求
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | functiondiscoveryapi.h |
| DLL | FunDisc.dll |