WsPushBytes 함수(webservices.h)

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

구문

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

매개 변수

[in] writer

바이트가 기록되는 XML Writer 개체에 대한 포인터입니다. 포인터는 유효한 WS_XML_WRITER 참조해야 하며 참조된 값은 NULL이 아닐 수 있습니다.

[in] callback

이 매개 변수는 데이터를 쓰기 위해 호출할 콜백입니다.

[in, optional] callbackState

콜백 함수에 전달되는 사용자 정의 상태에 대한 포인터입니다.

[in, optional] error

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

반환 값

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

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

설명

WS_XML_WRITER_MTOM_ENCODING 사용하여 쓸 때 WsPushBytes는 바이트를 자체 MIME 파트에 직접 작성하고 복사본을 방지하는 방법을 제공합니다. 그러나 작성자는 재량에 따라 콜백을 즉시 호출하도록 선택할 수 있으므로 호출자가 이에 대비해야 합니다.

인코딩이 이 동작을 활용할 수 없는 경우 WsPushBytes 는 즉시 콜백을 호출하고 WsWriteBytes 가 호출된 것처럼 작동합니다.

요구 사항

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