WsWriteXmlBufferToBytes 함수(webservices.h)

  • 아티클

기록기를 사용하여 WS_XML_BUFFER 인코딩된 바이트 집합으로 변환합니다.

구문

HRESULT WsWriteXmlBufferToBytes(
  [in]           WS_XML_WRITER                *writer,
  [in]           WS_XML_BUFFER                *xmlBuffer,
  [in, optional] const WS_XML_WRITER_ENCODING *encoding,
                 const WS_XML_WRITER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
  [in]           WS_HEAP                      *heap,
                 void                         **bytes,
  [out]          ULONG                        *byteCount,
  [in, optional] WS_ERROR                     *error
);

매개 변수

[in] writer

인코딩된 바이트를 생성하는 데 사용할 작성기입니다.

[in] xmlBuffer

쓸 XML 버퍼입니다.

[in, optional] encoding

바이트를 생성할 때 사용할 인코딩입니다. NULL인 경우 바이트는 utf8로 인코딩됩니다.

properties

작성기의 선택적 속성 배열입니다. WS_XML_WRITER_PROPERTY 참조하세요.

[in] propertyCount

속성 수입니다.

[in] heap

바이트를 할당할 힙입니다.

bytes

생성된 바이트가 여기에 반환됩니다.

[out] byteCount

생성된 바이트 수가 여기에 반환됩니다.

[in, optional] error

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

반환 값

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

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

설명

함수는 지정된 인코딩의 지정된 힙에서 할당된 바이트의 선형 집합으로 WS_XML_BUFFER 전체 콘텐츠를 생성합니다.

작성기는 이 함수를 호출한 후 정의되지 않은 상태로 남습니다. 그러나 WsWriteXmlBufferToBytes 는 이러한 작성기와 함께 다시 사용할 수 있습니다. 그렇지 않으면 WsSetOutput 또는 WsSetOutputToBuffer 를 사용하여 작성기를 알려진 상태로 되돌리거나 WsFreeWriter를 사용하여 작성기를 해제해야 합니다.

요구 사항

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