共用方式為


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

    根據對像是類別或實例而定,會建立 CLASSINSTANCE 專案。

  • 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