IWbemServices::GetObject 方法 (wbemcli.h)
IWbemServices::GetObject方法會擷取類別或實例。 這個方法只會從與目前 IWbemServices 物件相關聯的命名空間中擷取物件。
語法
HRESULT GetObject(
[in] const BSTR strObjectPath,
[in] long lFlags,
[in] IWbemContext *pCtx,
[out] IWbemClassObject **ppObject,
[out] IWbemCallResult **ppCallResult
);
參數
[in] strObjectPath
要擷取的物件路徑。 如果這是 Null,則會傳回空物件,而該物件可能會成為新的類別。 如需詳細資訊,請參閱 建立類別。
[in] lFlags
下列旗標會影響此方法的行為。
WBEM_FLAG_USE_AMENDED_QUALIFIERS
如果設定此旗標,WMI 會擷取儲存在目前連線地區設定之當地語系化命名空間中的修改限定詞。 如果未設定,只會擷取儲存在立即命名空間中的限定詞。
WBEM_FLAG_RETURN_WBEM_COMPLETE
此旗標會進行同步呼叫。
WBEM_FLAG_RETURN_IMMEDIATELY
此旗標會進行半非同步呼叫。 您必須提供 ppCallResult 參數的有效指標。 如需詳細資訊,請參閱 呼叫方法。
WBEM_FLAG_DIRECT_READ
此旗標會導致直接存取指定的類別提供者,而不需考慮其父類別或子類別。
[in] pCtx
通常 為 Null。 否則,這是 IWbemCoNtext 物件的指標,可由產生要求的類別或實例的提供者使用。 內容物件中的值必須在有問題的提供者檔中指定。 如需此參數的詳細資訊,請參閱 呼叫 WMI。
[out] ppObject
如果不是 Null,則會在找到物件時接收物件。 傳回的物件具有正參考計數。 當不再需要物件時,呼叫端必須使用 Release 。 在所有錯誤情況下,此參數都會設定為指向 Null。
[out] ppCallResult
如果 為 Null,則不會使用此參數。 如果 lFlags 參數包含 WBEM_FLAG_RETURN_IMMEDIATELY,此呼叫會立即傳回 WBEM_S_NO_ERROR。 ppCallResult參數會接收新IWbemCallResult物件的指標,然後可以使用GetCallStatus方法輪詢以取得結果。 呼叫端可以呼叫 IWbemCallResult::GetResultObject ,以在物件可用時擷取物件。
傳回值
這個方法會傳回 HRESULT ,指出方法呼叫的狀態。 下列清單列出 HRESULT中包含的值。
失敗時,您可以從 COM 函式 GetErrorInfo取得任何可用資訊。
如果網路問題造成您失去 Windows 管理遠端連線,也可能傳回 COM 特定的錯誤碼。
規格需求
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | wbemcli.h (包含 Wbemidl.h) |
程式庫 | Wbemuuid.lib |
Dll | Fastprox.dll;Esscli.dll;FrameDyn.dll;FrameDynOS.dll;Ntevt.dll;Stdprov.dll;Viewprov.dll;Wbemcomn.dll;Wbemcore.dll;Wbemess.dll;Wbemsvc.dll;Wmipicmp.dll;Wmidcprv.dll;Wmipjobj.dll;Wmiprvsd.dll |