CWbemProviderGlue::GetAllInstances 方法 (wbemglue.h)
[ CWbemProviderGlue 類別是 WMI 提供者架構的一部分,它現在被視為最終狀態,而且不會針對影響這些連結庫的非安全性相關問題進一步開發、增強功能或更新。 MI API 應該用於所有新的開發。]
GetAllInstances 方法會擷取特定類別所傳回的實例清單。
語法
HRESULT GetAllInstances(
LPCWSTR pszClassName,
TRefPointerCollection<CInstance> *pList,
LPCWSTR pszNamespace,
MethodContext *pMethodContext
);
參數
pszClassName
應該傳回實例清單的類別名稱。
pList
pszClassName 所指定提供者所支持的實例連結清單。
pszNamespace
pszClassName 所指定之提供者的命名空間。 這個參數可以是 NULL ,表示預設命名空間,也就是 “Root\CIMv2”。
pMethodContext
目前內容的指標。 必須提供內容以防止死結。 使用 由 Provider::EnumerateInstances 或 Provider::ExecQuery 傳遞至提供者的內容,或使用 CInstance::GetMethodContext 從實例取得它。 此參數不得為 NULL。
傳回值
如果作業成功,此方法會傳回WBEM_S_NO_ERROR,WBEM_E_OUT_OF_MEMORY作業因記憶體不足或任何其他 HRESULT 錯誤碼而失敗。
備註
GetAllInstances 方法可讓架構提供者從另一個提供者存取數據,而不需要進行 WMI API 呼叫。 架構提供者會將提供者的名稱傳遞至 GetAllInstances,這會傳回提供者支援的所有實例清單。
這個方法在語意上相當於查詢 SELECT * FROM pszBaseClassName WHERE __Class = pszBaseClassName。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | wbemglue.h (include FwCommon.h) |
程式庫 | FrameDyn.lib |
Dll | FrameDynOS.dll;FrameDyn.dll |