Share via

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 提供者

效能計數器提供者