共用方式為


IWbemConfigureRefresher::AddObjectByPath 方法 (wbemcli.h)

IWbemConfigureRefresher::AddObjectByPath 方法會藉由指定對象路徑,將物件新增至重新整理器。

語法

HRESULT AddObjectByPath(
  [in]  IWbemServices    *pNamespace,
  [in]  LPCWSTR          wszPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

參數

[in] pNamespace

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

[in] wszPath

常數,以 Null 結尾的 16 位 Unicode 字元字串,其中包含您新增至重新整理器之物件的物件路徑。

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

效能計數器提供者