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를 사용합니다. 이 값을 사용하면 포함된 개체 또는 scope 같은 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

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