SWbemObjectEx.GetText_ 메서드

SWbemObjectEx 개체의 GetText_ 메서드는 개체 또는 인스턴스의 XML 표현을 반환합니다. 텍스트 파일은 WbemObjectTextFormatEnum에 표시된 대로 지정된 XML 형식으로 지정됩니다.

이 구문에 대한 설명은 스크립팅 API의 문서 규칙을 참조하세요.

구문

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

매개 변수

iTextFormat [in]

필수 요소. 결과 XML 형식을 지정하는 WbemObjectTextFormatEnum의 값입니다.

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: <클래스> 또는 <INSTANCE> 요소는 개체가 클래스인지 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