WsFlushWriter 함수(webservices.h)

충분한 데이터가 버퍼링된 경우 WS_XML_WRITER_STREAM_OUTPUT 지정된 콜백을 호출하도록 기록기에 지시합니다.

구문

HRESULT WsFlushWriter(
  [in]           WS_XML_WRITER          *writer,
  [in]           ULONG                  minSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

매개 변수

[in] writer

플러시할 기록기입니다.

[in] minSize

콜백을 호출하기 위해 버퍼링해야 하는 최소 바이트 수를 지정합니다. 이 바이트 수보다 적은 바이트가 버퍼링되면 콜백 이 호출되지 않습니다. 소량의 데이터를 쓸 때 발생하는 i/o의 수를 최소화하는 데 사용할 수 있습니다.

콜백이 호출되도록 0을 지정해야 합니다.

[in, optional] asyncContext

함수를 비동기적으로 호출하는 방법 또는 동기적으로 호출하는 경우 NULL 에 대한 정보입니다.

[in, optional] error

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

반환 값

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

반환 코드	설명
E_INVALIDARG	하나 이상의 인수가 잘못되었습니다.
WS_S_ASYNC	비동기 작업은 아직 보류 중입니다.

설명

기록기는 WsFlushWriter 가 호출될 때까지 모든 데이터를 버퍼링합니다.

필요한 경우 WsFreeWriter 전에 WsFlushWriter를 호출하여 모든 데이터가 내보내지 않도록 해야 합니다.

WS_ASYNC_CONTEXT 지정하면 버퍼링된 데이터가 비동기적으로 기록됩니다.

작성기가 WS_XML_WRITER_BUFFER_OUTPUT 사용하는 경우 이 함수는 no-op입니다.

WsWriteStartElement가 호출되었지만 요소가 커밋되지 않은 경우(WsWriteStartElement 참조) 이 요소는 플러시되지 않습니다.

WS_XML_WRITER_MTOM_ENCODING 사용할 때 이 함수가 호출되고 작성기에 열려 있는 요소가 없으면 지원 MIME 부분이 생성되고 내보내집니다. 이 경우 XML 문서에 더 쓰려는 모든 API는 WS_E_INVALID_OPERATION 반환합니다. ( Windows Web Services 반환 값을 참조하세요.)

요구 사항

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