WbebemClassObject::GetObjectText 方法 (wbemcli.h)
IWbemClassObject::GetObjectText方法會傳回 MOF 語法中物件的文字轉譯。 請注意,傳回的 MOF 文字不包含物件的所有資訊,但只有足夠的資訊可供 MOF 編譯器重新建立原始物件。 例如,不會顯示傳播的限定詞或父類別屬性。
語法
HRESULT GetObjectText(
[in] long lFlags,
[out] BSTR *pstrObjectText
);
參數
[in] lFlags
通常為 0。 如果指定 了WBEM_FLAG_NO_FLAVORS ,則會顯示限定詞,而不會傳播或類別資訊。
[out] pstrObjectText
這必須指向專案上的 Null 。 此參數會從 Windows Management 接收以SysAllocString初始化的新配置BSTR。 當不再需要字串時,您必須在指標上呼叫 SysFreeString 。 這個指標指向從呼叫傳回時,物件的 MOF 語法轉譯。 因為這是 out 參數,所以指標不得指向呼叫此方法之前有效的字串,因為不會解除配置指標。
傳回值
這個方法會傳回 HRESULT ,指出方法呼叫的狀態。 下列清單列出 HRESULT中包含的值。 如需一般 HRESULT 值,請參閱 系統錯誤碼。
備註
下列演算法可用來重新建構方法參數的文字:
- 參數會依其識別碼值的順序重設排序。
- 指定為 [in] 和 [out] 的參數將會合並成單一參數。
規格需求
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | wbemcli.h (包含 Wbemidl.h) |
程式庫 | WbemUuid.lib |
Dll | CIMWin32.dll;Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll;Wbemess.dll;Wmipiprt.dll |