共用方式為


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