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

效能計數器提供者