[函式探索可用於需求一節中指定的作業系統。 後續版本可能會變更或無法使用。]
取得提供者實例的識別碼字串。 此字串是提供者實例的唯一識別碼。
語法
HRESULT GetProviderInstanceID(
[out] WCHAR **ppszCoMemProviderInstanceIdentity
);
參數
[out] ppszCoMemProviderInstanceIdentity
提供者實例識別碼字串。 對於根裝置，此字串的值與PKEY_PNPX_GlobalIdentity相同。
請務必使用 CoTaskMemFree釋放此緩衝區。
傳回值
可能的傳回值包括但不限於下列各項。
| 傳回碼 | 描述 |
|---|---|
|
已成功完成命令。 |
|
ppszCoMemProviderInstanceID的值無效。 |
|
方法無法配置執行這項作業所需的記憶體。 |
需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | functiondiscoveryapi.h |
| Dll | FunDisc.dll |