WsFillReader 함수(webservices.h)

판독기가 후속 판독기 함수에서 사용할 XML 데이터의 최소 바이트 수를 버퍼링했는지 확인합니다. minSize 매개 변수 값으로 지정된 바이트 수를 가져오는 데 필요한 횟수만큼 WS_XML_READER_STREAM_INPUT 지정된 콜백을 호출합니다. 완료되면 버퍼링된 데이터를 다른 판독기 함수에서 사용할 수 있습니다. 후속 판독기 함수에 가져온 것보다 더 많은 데이터가 필요한 경우 함수는 WS_E_QUOTA_EXCEEDED 예외를 반환합니다. ( Windows Web Services 반환 값을 참조하세요.)

구문

HRESULT WsFillReader(
  [in]           WS_XML_READER          *reader,
  [in]           ULONG                  minSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

매개 변수

[in] reader

데이터를 가져오는 데 사용되는 WS_XML_READER 구조체에 대한 포인터입니다.

[in] minSize

판독기가 가져와야 하는 최소 바이트 수를 지정합니다. 버퍼링된 현재 바이트 수가 minSize 값과 같거나 크면 함수는 아무 작업도 수행하지 않으며 즉시 반환됩니다.

[in, optional] asyncContext

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

[in, optional] error

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

반환 값

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

반환 코드	설명
WS_S_ASYNC	비동기 작업은 아직 보류 중입니다.

설명

XML 데이터의 특정 세그먼트를 읽는 데 필요한 바이트 수는 인코딩 및 해당 형식에 따라 달라집니다.

이 함수는 WS_XML_READER_BUFFER_INPUT 사용하여 판독기에서 사용할 때 "no-op"입니다.

WS_ASYNC_CONTEXT 지정하여 데이터를 비동기적으로 읽습니다.

요구 사항

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