IWbemConfigureRefresher::AddObjectByTemplate 方法 (wbemcli.h)
使用 IWbemConfigureRefresher::AddObjectByTemplate 方法,您可以藉由指定 IWbemClassObject 實例範本,將您想要重新整理的物件新增至重新整理器。 當難以為物件建構物件路徑以新增至重新整理器時,請使用這個方法。
語法
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 |