WsWriteBytes 함수(webservices.h)

  • 아티클

인코딩에 최적화된 형식으로 작성기에 바이트를 씁니다. 텍스트 인코딩을 작성할 때 base64로 인코딩된 바이트를 내보냅니다. 이진 형식으로 쓸 때 바이트를 직접 내보냅니다.

구문

HRESULT WsWriteBytes(
  [in]           WS_XML_WRITER *writer,
                 const void    *bytes,
  [in]           ULONG         byteCount,
  [in, optional] WS_ERROR      *error
);

매개 변수

[in] writer

바이트를 쓸 작성기입니다.

bytes

문서에 쓸 바이트입니다.

[in] byteCount

문서에 쓸 바이트 수입니다.

[in, optional] error

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

반환 값

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

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

설명

WsWriteBytes 는 WsWriteStartAttribute 와 WsWriteEndAttribute 간에 두 번 이상 호출될 수 있습니다. 특성을 작성할 때 WsWriteChars, WsWriteCharsUtf8, WsWriteValue 또는 WsWriteText 와 결합되지 않을 수 있습니다.

WS_XML_WRITER_MTOM_ENCODING 대해 byteCount가 WsSetOutput 중에 지정된 maxInlineByteCount를 초과하면 바이트가 버퍼링되고 자체 MIME 부분에 배치됩니다. 그렇지 않으면 바이트가 base64로 인코딩되어 문서에 직접 배치됩니다.

WS_XML_WRITER_MTOM_ENCODING 바이트를 포함하는 요소에 이름이 'contentType'이고 네임스페이스가 'http://www.w3.org/2004/11/xmlmime'인 특성이 있는 경우 특성 값은 XML 이진 최적화 패키징에 설명된 대로 MIME 파트의 콘텐츠 형식 헤더에 반영됩니다.

요구 사항

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