다음을 통해 공유

WsPullBytes 함수(webservices.h)

  • 아티클

호출할 콜백을 설정하여 요소 내에 쓸 바이트를 가져옵니다.
일부 인코딩에서는 데이터 복사본을 제거하여 더 효율적일 수 있습니다.

구문

HRESULT WsPullBytes(
  [in]           WS_XML_WRITER          *writer,
  [in]           WS_PULL_BYTES_CALLBACK callback,
  [in, optional] void                   *callbackState,
  [in, optional] WS_ERROR               *error
);

매개 변수

[in] writer

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

[in] callback

이진 데이터를 쓸 때 호출할 콜백입니다.

[in, optional] callbackState

콜백에 전달할 사용자 정의 상태입니다.

[in, optional] error

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

반환 값

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

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

설명

WsWriteBytes 및 WsPushBytes 는 데이터 버퍼를 작성기에 제공해야 합니다. 일부 사용 패턴에서는 데이터의 추가 복사본이 필요할 수 있습니다. 이러한 시나리오의 경우 WsPullBytes 는 기록기에 데이터로 채워야 하는 버퍼를 제공하도록 요청하는 방법을 제공합니다.

인코딩이 이 동작을 활용할 수 없는 경우 WsPullBytes 는 즉시 콜백을 호출하고 결과 데이터에 대해 WsWriteBytes 가 호출된 것처럼 작동합니다.

요구 사항

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