共用方式為


IWbemConfigureRefresher::AddObjectByTemplate 方法 (wbemcli.h)

使用 IWbemConfigureRefresher::AddObjectByTemplate 方法,您可以藉由指定 IWbemClassObject 實例範本,將您想要重新整理的物件新增至重新整理器。 當難以為物件建構物件路徑以新增至重新整理器時,請使用這個方法。

注意 必須先填寫實例物件的索引鍵屬性,才能呼叫 AddObjectByTemplate 方法。
 

語法

HRESULT AddObjectByTemplate(
        IWbemServices    *pNamespace,
  [in]  IWbemClassObject *pTemplate,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

參數

pNamespace

IWbemServices 指標回到 Windows 管理,可服務提供者提出的任何要求。 如果提供者在執行期間要回呼 Windows Management,提供者應該在此指標上呼叫 AddRef

[in] pTemplate

包含實例範本的 IWbemClassObject 物件的指標。

[in] lFlags

修改此方法行為的旗標位掩碼。 如果此參數設定為 WBEM_FLAG_USE_AMENDED_QUALIFIERS,則傳回的實例將會包含當地語系化限定符。

[in] pContext

通常 為 NULL;否則,一或多個動態類別提供者所需的 IWbemContext 物件的指標。 內容物件中的值必須在特定提供者檔中指定。 如需此參數的詳細資訊,請參閱 呼叫 WMI

[out] ppRefreshable

保存 IWbemClassObject 對象的參考指標,其中包含可重新整理的實例物件。 用戶端在不再需要時,必須在傳回的物件上呼叫 Release

[out] plId

提供者傳回的整數指標,這個整數可唯一識別這個可重新整理的物件。

傳回值

這個方法會傳回 HRESULT ,指出方法呼叫的狀態。 下列清單列出 HRESULT 中包含的值。

備註

提供的實例必須指定有效的 物件,該物件是由 High-Performance 提供者所提供。 當重新整理作業正在進行時,用戶端不得修改傳回的物件。 Remove 函式可以使用傳回的標識碼來移除物件。

使用者不需要明確移除新增的物件。 用戶端在不再需要時,必須在傳回的物件上呼叫 Release

規格需求

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

另請參閱

存取 C++ 中的效能數據

IWbemConfigureRefresher

將實例提供者變成 High-Performance 提供者

效能計數器提供者