CWbemProviderGlue::GetInstanceKeysByPath 方法 (wbemglue.h)
[ CWbemProviderGlue 類別是 WMI 提供者架構的一部分,它現在被視為最終狀態,而且不會針對影響這些連結庫的非安全性相關問題進一步開發、增強功能或更新。 MI API 應該用於所有新的開發。]
GetInstanceKeysByPath 方法會擷取特定物件路徑所識別的實例,其中只會填入索引鍵屬性。
語法
HRESULT GetInstanceKeysByPath(
LPCWSTR pszInstancePath,
CInstance **ppInstance,
MethodContext *pMethodContext
);
參數
pszInstancePath
要傳回之實例的物件路徑。
ppInstance
指向新 CInstance 實例指標的指標,其索引鍵是 pszInstancePath 中指定的索引鍵。 執行要求的架構提供者必須釋放此指標。
pMethodContext
目前內容的指標。 必須提供內容以防止死結。 使用 由 Provider::EnumerateInstances 或 Provider::ExecQuery 傳遞至提供者的內容,或使用 CInstance::GetMethodContext 從實例取得它。 此參數不得為 NULL。
傳回值
如果作業成功,則傳回WBEM_S_NO_ERROR,WBEM_E_OUT_OF_MEMORY作業因記憶體不足或任何其他 HRESULT 錯誤碼而失敗。
備註
這個方法會使用部分實例更新作業,只要求指定物件的索引鍵屬性。 這是驗證特定物件是否存在的最有效率方式。 請注意,並非所有提供者都支援部分實例作業。 在此情況下,將會填入整個實例。 如需詳細資訊,請參閱 支援 Partial-Instance 作業。
在目前版本的提供者架構中, pszInstancePath 必須解析為相同計算機上的實例路徑。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | wbemglue.h (include FwCommon.h) |
程式庫 | FrameDyn.lib |
Dll | FrameDynOS.dll;FrameDyn.dll |