SWbemObjectEx.GetText_ メソッド

SWbemObjectEx オブジェクトの GetText_ メソッドは、オブジェクトまたはインスタンスの XML 表現を返します。 テキスト ファイルは、WbemObjectTextFormatEnum に示すように指定された XML 形式で書式設定されます。

この構文の説明については、スクリプト API のドキュメント規則に関するページを参照してください。

構文

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

パラメーター

iTextFormat [in]

必須。 結果の XML 形式を指定する WbemObjectTextFormatEnum の値。

iFlags [in、省略可能]

予約済み操作フラグ。 既定値は 0 (ゼロ) です。

objWbemNamedValueSet [in、省略可能]

操作のコンテキストを設定する SWbemNamedValueSet オブジェクト。 既定値は null です。 許可される名前と値のペアの詳細については、下記の「解説」を参照してください。

戻り値

このメソッドには戻り値がありません。

エラー コード

GetText_ メソッドの完了後、Err オブジェクトに次の一覧にあるいずれかのエラー コードが含まれる場合があります。

wbemErrFailed - 2147749889 (0x80041001)

未定義のエラーが発生しました。

wbemErrNotFound - 2147749890 (0x80041002)

要求された形式が見つかりませんでした。

wbemErrInvalidParameter - 2147749896 (0x80041008)

呼び出しに渡したパラメーターのいずれかが正しくありません。

wbemErrCriticalError - 2147749898 (0x8004100A)

予期しない重大な内部エラーが発生しました。 このエラーについては、Microsoft テクニカル サポートに連絡してください。

解説

SWbemNamedValueSet を構築する場合、次の名前と値のペアのみが許可されます。

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

要件