SWbemObjectEx.GetText_ 方法

SWbemObjectEx物件的GetText_方法會傳回物件或實例的 XML 標記法。 文字檔會以指定的 XML 格式格式化，如 WbemObjectTextFormatEnum所示。

如需此語法的說明，請參閱 腳本 API 的檔慣例。

語法

strObj = .GetText_( _
  ByVal iTextFormat, _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

參數

iTextFormat [in]

必要。 WbemObjectTextFormatEnum的值，指定產生的 XML 格式。

iFlags [in， optional]

保留的作業旗標。 預設值是 0 (零)。

objWbemNamedValueSet [in， optional]

設定作業內容的 SWbemNamedValueSet 物件。 預設值是 null。 如需允許之名稱/值組的詳細資訊，請參閱下方的。

傳回值

這個方法沒有傳回值。

錯誤碼

完成 GetText_ 方法之後， Err 物件可能會包含下列清單中的其中一個錯誤碼。

wbemErrFailed - 2147749889 (0x80041001)

未指定的錯誤。

wbemErrNotFound - 2147749890 (0x80041002)

找不到要求的格式。

wbemErrInvalidParameter - 2147749896 (0x80041008)

呼叫的其中一個參數不正確。

wbemErrCriticalError - 2147749898 (0x8004100A)

發生內部嚴重意外錯誤。 請向 Microsoft 技術支援反映這個錯誤。

備註

建構 SWbemNamedValueSet時，只允許下列名稱/值組。

名稱	值
LocalOnly	VT_BOOL 如果 為 TRUE，則只會在本機定義的屬性和方法出現在產生的 XML 中。 預設值為 FALSE。
IncludeQualifiers	VT_BOOL 如果 為 TRUE，則產生的 XML 中包含類別、實例、屬性和方法的限定詞。 預設值為 FALSE。
PathLevel	VT-I4 預設值為 0 (零) 。 可能的值包括： 0： < 根據物件是類別或實例而定，會建立 CLASS > 或 < INSTANCE > 元素。 1：值 < 。產生 NAMEDOBJECT > 元素。 2：值 > 。產生 OBJECTWITHLOCALPATH > 元素。 3：值 > 。產生 OBJECTWITHPATH > 元素。
ExcludeSystemProperties	VT-BOOL 如果 為 TRUE，系統屬性__NAMESPACE會從輸出中排除。
IncludeClassOrigin	VT_BOOL 如果為 TRUE，則會在 PROPERTY > 和 > METHOD 元素上 > 設定類別原點 > 屬性。 預設值為 FALSE。

如需建立 SWbemNamedValueSet的詳細資訊，請參閱 SWbemNamedValueSet.Add。

範例

下列腳本示範如何取得 Win32_Bios 類別定義的 XML 標記法。 藉由指定 特定實例Win32_Bios，您可以在 XML 中取得該物件的資料。

' Connect to the default namespace (root\cimv2) with the default
' impersonation level ("impersonate") and obtain a Win32_Bios class
' object.
Set obj = GetObject("winmgmts:win32_bios")

' Use the value for the desired XML CIM DTD format. 
XMLDtd = 1
Text = obj.GetText_(XMLDtd)
wscript.echo Text

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
標頭	Wbemdisp.h
類型程式庫	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObjectEx
IID	IID_ISWbemObjectEx