다음을 통해 공유

WsFillBody 함수(webservices.h)

  • 아티클

메시지에서 읽기에 사용할 수 있는 바이트가 충분한지 확인합니다. 읽을 다음 XML 구문을 포함하기에 충분한 바이트 수를 지정하는 것은 애플리케이션에 달려 있습니다.

참고 이 함수는 WsReadBody 또는 메시지의 XML Reader를 사용하여 메시지 본문을 읽기 전에 호출됩니다.
 

이 함수는 메시지를 작성하는 데 사용되는 XML 판독 기용 WsFillReader 를 호출하기 위한 바로 가기입니다. WsFillReader를 직접 호출하는 것은 이 함수를 호출하는 것과 같습니다.

구문

HRESULT WsFillBody(
  [in]           WS_MESSAGE             *message,
  [in]           ULONG                  minSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

매개 변수

[in] message

"채우기"를 위한 WS_MESSAGE 구조체에 대한 포인터입니다.

[in] minSize

메시지가 버퍼링되어야 하는 최소 바이트 수입니다. 버퍼링된 현재 바이트 수가 minSize 값과 같거나 큰 경우 함수는 아무 작업도 수행하지 않습니다.

참고minSize 값은 예상되는 XML의 인코딩된 형식의 크기를 나타냅니다. 인코딩 및 실제 XML의 구조에 따라 달라질 수 있습니다. 이 함수의 일반적인 사용은 인코딩 또는 XML 구조에 대해 예상되는 상한 바이트 수를 선택하여 예상 데이터를 읽도록 하는 것입니다.
 

[in, optional] asyncContext

함수를 비동기적으로 호출하는 방법에 대한 정보가 포함된 WS_ASYNC_CONTEXT 데이터 구조체에 대한 포인터입니다. NULL 값은 동기 작업에 대한 요청을 나타냅니다.

[in, optional] error

함수가 실패할 경우 오류에 대한 추가 정보를 저장해야 하는 WS_ERROR 개체에 대한 포인터입니다.

반환 값

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

반환 코드 Description
S_OK
 메시지 시작이 성공적으로 수신되었습니다.
WS_S_ASYNC
 비동기 작업은 아직 보류 중입니다.
WS_E_INVALID_FORMAT
 입력 데이터가 예상 형식이 아니거나 예상 값이 없습니다.
E_INVALIDARG
 하나 이상의 인수가 잘못되었습니다.
E_OUTOFMEMORY
 메모리가 부족합니다.
기타 오류
이 함수는 위에 나열되지 않은 다른 오류를 반환할 수 있습니다.

설명

이 함수는 일반적으로 스트리밍 모드가 WS_STREAMED_OUTPUT_TRANSFER_MODE 설정된 메시지 본문을 작성하거나 스트리밍 모드에서 XML 판독기를 사용할 때 사용됩니다.

이 함수는 메시지 본문을 작성할 때 "no-op"이고 WS_STREAMED_OUTPUT_TRANSFER_MODE 설정되지 않았거나 XML 판독기 모드가 WS_XML_READER_BUFFER_INPUT 설정됩니다.

요구 사항

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