[函式探索可用於需求一節中指定的作業系統。 後續版本可能會變更或無法使用。]
取得函式實例的標識符字串。 此標識符可以儲存,並稍後用來透過 IFunctionDiscovery::GetInstance 重新查詢相同的函式實例。
語法
HRESULT GetID(
[out] WCHAR **ppszCoMemIdentity
);
參數
[out] ppszCoMemIdentity
函式實例識別符字串。 此字串的大小沒有上限。
此字串是由函式探索所產生的組成字串。 其具有提供者實例標識符字串做為子字串。 如需提供者標識碼的詳細資訊,請參閱 IFunctionInstance::GetProviderInstanceID。
對於內建提供者所傳回的函式實例,此標識符保證能夠唯一識別系統上的資源,即使資源已中斷連線並重新連線也一樣。 對於自定義提供者所傳回的函式實例,如果提供者具有唯一提供者標識符,則函式實例標識碼是唯一的。
此標識碼不應以程序設計方式操作或製造。 字串應該只用來擷取函式實例,並用於比較用途。
請務必使用 CoTaskMemFree 釋放此緩衝區。
傳回值
可能的傳回值包括但不限於下列各項。
| 傳回碼 | 描述 |
|---|---|
|
已成功完成命令。 |
|
ppszCoMemID 的值無效。 |
|
方法無法配置執行這項作業所需的記憶體。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | functiondiscoveryapi.h |
| Dll | FunDisc.dll |