Share via


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 ,指出方法呼叫的狀態。 下列清單列出 內含的值

注意HRESULT

 
.

備註

提供的類別必須指定有效的類別,該類別是由 High-Performance 提供者所提供。 在呼叫之後,可以查詢傳回之列舉值的所有實例。 在每次重新整理呼叫時,列舉值中的實例數目可能會有所不同。 只會傳回指定類別名稱的實例;不會列舉指定類別的子類別,因為不支持詳細的列舉。 當 重新 整理作業正在進行時,用戶端不得觸碰傳回的列舉值。 Remove 函式可以使用傳回的標識碼來移除物件。 請注意,使用者不需要明確移除新增的列舉值。 不過,當不再需要時,客戶端必須在傳回的列舉值上呼叫 Release

規格需求

需求
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 wbemcli.h (包含 Wbemidl.h)
程式庫 Wbemuuid.lib

另請參閱

IWbemConfigureRefresher