IWbemConfigureRefresher::AddEnum 方法 (wbemcli.h)
IWbemConfigureRefresher::AddEnum 方法會將列舉值新增至要求的重新整理器。
語法
HRESULT AddEnum(
[in] IWbemServices *pNamespace,
[in] LPCWSTR wszClassName,
[in] long lFlags,
[in] IWbemContext *pContext,
[out] IWbemHiPerfEnum **ppEnum,
[out] long *plId
);
參數
[in] pNamespace
IWbemServices 指標回到 Windows 管理,可為提供者提出的任何要求提供服務。 如果方法在執行期間必須回呼 Windows Management,提供者應該使用 pNamespace 指標呼叫 AddRef。
[in] wszClassName
包含列舉之類別名稱的16位Unicode字元常數、以 Null 結束的字串。
[in] lFlags
修改此方法行為的旗標位掩碼。 如果此參數設定為 WBEM_FLAG_USE_AMENDED_QUALIFIERS,則傳回的實例會包含當地語系化限定符。
[in] pContext
通常 為 NULL;否則,這是一或多個動態類別提供者所需的 IWbemContext 物件的指標。 內容物件中的值必須在特定提供者檔中指定。 如需此參數的詳細資訊,請參閱 呼叫 WMI。
[out] ppEnum
保存 IWbemHiPerfEnum 對象的參考指標,其中包含 列舉。 當不再需要時,客戶端必須在此指標上呼叫 Release 。
[out] plId
提供者所傳回之整數的指標,可唯一識別可重新整理的列舉。
傳回值
這個方法會傳回 HRESULT ,指出方法呼叫的狀態。 下列清單列出 內含的值
備註
提供的類別必須指定有效的類別,該類別是由 High-Performance 提供者所提供。 在呼叫之後,可以查詢傳回之列舉值的所有實例。 在每次重新整理呼叫時,列舉值中的實例數目可能會有所不同。 只會傳回指定類別名稱的實例;不會列舉指定類別的子類別,因為不支持詳細的列舉。 當 重新 整理作業正在進行時,用戶端不得觸碰傳回的列舉值。 Remove 函式可以使用傳回的標識碼來移除物件。 請注意,使用者不需要明確移除新增的列舉值。 不過,當不再需要時,客戶端必須在傳回的列舉值上呼叫 Release 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | wbemcli.h (包含 Wbemidl.h) |
程式庫 | Wbemuuid.lib |