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 值，請參閱 系統錯誤碼。

備註

下列演算法可用來重新建構方法參數的文字：

  1. 參數會依其識別碼值的順序重設排序。
  2. 指定為 [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

另請參閱

IWbemClassObject

IWbemQualifierSet

WBEM_TEXT_FLAG_TYPE