다음을 통해 공유


WS_READ_CALLBACK 콜백 함수(webservices.h)

WS_XML_READER 일부 원본에서 버퍼로 읽는 데 사용됩니다.

구문

WS_READ_CALLBACK WsReadCallback;

HRESULT WsReadCallback(
  [in]           void *callbackState,
                 void *bytes,
  [in]           ULONG maxSize,
  [out]          ULONG *actualSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR *error
)
{...}

매개 변수

[in] callbackState

이 콜백을 수락한 함수에 전달된 사용자 정의 상태 값에 대한 void 포인터입니다.

bytes

데이터를 배치해야 하는 위치에 대한 void 포인터입니다.

[in] maxSize

읽을 수 있는 최대 바이트 수입니다.

[out] actualSize

실제로 읽은 바이트 수를 나타내는 ULONG 값에 대한 포인터입니다. maxSize보다 작을 수 있습니다. 0을 반환하면 더 이상 데이터가 없음을 나타냅니다.

[in, optional] asyncContext

함수를 비동기적으로 호출하는 방법에 대한 정보를 포함하는 WS_ASYNC_CONTEXT 구조체에 대한 포인터입니다. 동기적으로 호출하는 경우 NULL 이 할당됩니다.

[in, optional] error

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

반환 값

이 콜백 함수는 값을 반환하지 않습니다.

설명

actualSize 출력 매개 변수에서 0의 크기를 반환하는 것은 파일의 끝을 나타냅니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 webservices.h