다음을 통해 공유

WsReadXmlBufferFromBytes 함수(webservices.h)

  • 아티클

판독기를 사용하여 인코딩된 바이트 집합을 WS_XML_BUFFER 변환합니다.

구문

HRESULT WsReadXmlBufferFromBytes(
  [in]           WS_XML_READER                *reader,
  [in, optional] const WS_XML_READER_ENCODING *encoding,
                 const WS_XML_READER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 const void                   *bytes,
  [in]           ULONG                        byteCount,
  [in]           WS_HEAP                      *heap,
                 WS_XML_BUFFER                **xmlBuffer,
  [in, optional] WS_ERROR                     *error
);

매개 변수

[in] reader

인코딩된 바이트를 구문 분석하는 데 사용할 판독기입니다.

[in, optional] encoding

바이트를 구문 분석할 때 사용할 인코딩입니다. NULL이면 문자 집합이 WS_CHARSET_AUTOWS_XML_READER_TEXT_ENCODING 사용됩니다.

properties

판독기의 선택적 속성 배열입니다. WS_XML_READER_PROPERTY 참조하세요.

[in] propertyCount

속성 수입니다.

bytes

구문 분석할 바이트입니다.

[in] byteCount

구문 분석할 바이트 수입니다.

[in] heap

XML 버퍼를 할당할 힙입니다.

xmlBuffer

바이트를 읽은 XML 버퍼가 여기에 반환됩니다.

[in, optional] error

함수가 실패할 경우 추가 오류 정보를 저장할 위치를 지정합니다.

반환 값

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 설명
E_INVALIDARG
 하나 이상의 인수가 잘못되었습니다.
WS_E_INVALID_OPERATION
 개체의 현재 상태로 인해 작업이 허용되지 않습니다.
WS_E_QUOTA_EXCEEDED
 할당량을 초과했습니다.

설명

함수는 지정된 인코딩에 따라 전체 내용을 구문 분석하고 WS_XML_BUFFER 저장합니다.

판독기는 이 함수를 호출한 후 정의되지 않은 상태로 남게 됩니다. 그러나 WsReadXmlBufferFromBytes 는 이러한 판독기에서 다시 사용할 수 있습니다. 그렇지 않으면 WsSetInput 또는 WsSetInputToBuffer 를 사용하여 판독기를 알려진 상태로 되돌리거나 WsFreeReader를 사용하여 판독기를 해제해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 webservices.h
라이브러리 WebServices.lib
DLL WebServices.dll