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 函式可以使用傳回的標識碼來移除物件。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | wbemcli.h (包含 Wbemidl.h) |
程式庫 | Wbemuuid.lib |