IWbemObjectTextSrc：：GetText 方法 (wbemcli.h)

IWbemObjectTextSrc：：GetText 方法會建立 IWbemClassObject 對象的文字表示法;例如，XML 表示法。

語法

HRESULT GetText(
  long             lFlags,
  IWbemClassObject *pObj,
  ULONG            uObjTextFormat,
  IWbemContext     *pCtx,
  BSTR             *strText
);

參數

lFlags

保留的。 必須是 0L。

pObj

要以文字格式表示之對象的參考。 此參數不可為 NULL。

uObjTextFormat

用來表示 物件的文字格式定義。 如需此參數有效值的詳細資訊，請參閱。

WMI_OBJ_TEXT_CIM_DTD_2_0 (1 (0x1) )

使用對應至 CIM DTD 2.0 版的 DTD。

WMI_OBJ_TEXT_WMI_DTD_2_0 (2 (0x2) )

使用對應至 CIM DTD 2.0 版的 WMI DTD。 使用此值可啟用 WMI 特定的延伸模組，例如內嵌物件或範圍。

WMI_OBJ_TEXT_WMI_EXT1 (3 (0x3) )

保留供未來使用。

WMI_OBJ_TEXT_WMI_EXT2 (4 (0x4) )

保留供未來使用。

WMI_OBJ_TEXT_WMI_EXT3 (5 (0x5) )

保留供未來使用。

WMI_OBJ_TEXT_WMI_EXT4 (6 (0x6) )

保留供未來使用。

WMI_OBJ_TEXT_WMI_EXT5 (7 (0x7) )

保留供未來使用。

WMI_OBJ_TEXT_WMI_EXT6 (8 (0x8) )

保留供未來使用。

WMI_OBJ_TEXT_WMI_EXT7 (9 (0x9) )

保留供未來使用。

WMI_OBJ_TEXT_WMI_EXT8 (10 (0xA) )

保留供未來使用。

WMI_OBJ_TEXT_WMI_EXT9 (11 (0xB) )

保留供未來使用。

WMI_OBJ_TEXT_WMI_EXT10 (12 (0xC) )

保留供未來使用。

WMI_OBJ_TEXT_LAST (13 (0xD) )

保留供未來使用。

pCtx

選擇性。 作業的內容物件。 內容物件可用來指定物件的某些部分是否以文字表示;例如，是否要在文字表示中包含限定符。 內容對象會採用下列選擇性值。

LocalOnly (VT_BOOL)

如果 為 TRUE，則只會在本機定義的屬性和方法出現在產生的 XML 中。 預設值為 FALSE。

IncludeQualifiers (VT_BOOL)

如果 為 TRUE，則輸出中會包含類別、實例、屬性和方法的限定符。 預設值為 FALSE。

PathLevel (VT_I4)

預設值是 0 (零)。

可能的值包括：

• 0

  根據對像是類別或實例而定，會建立 CLASS 或 INSTANCE 專案。

• 1

  值。產生 NAMEDOBJECT 元素。

• 2

  值。產生 OBJECTWITHLOCALPATH 元素。

• 3

  值。產生 OBJECTWITHPATH 元素。

ExcludeSystemProperties (VT_BOOL)

如果 為 TRUE，則輸出中沒有 __NAMESPACE等系統屬性。 預設值為 FALSE。

IncludeClassOrigin (VT_BOOL)

如果 為 TRUE，則會在 PROPERTY 和 METHOD 元素上設定類別原 點 屬性。 預設值為 FALSE。

strText

物件的文字表示。 用戶必須在使用 strText 完成時，使用 SysFreeString 釋放字串。

傳回值

這個方法會傳回 HRESULT ，指出方法呼叫的狀態。 下列清單列出 HRESULT 中包含的值。

備註

如需詳細資訊，請參閱 以 XML 表示物件。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	wbemcli.h (包含 Wbemidl.h)
程式庫	Wbemuuid.lib
Dll	Fastprox.dll