Compartir a través de

Función WsPushBytes (webservices.h)

  • Artículo

Establece una devolución de llamada que se va a invocar para escribir bytes dentro de un elemento. En algunas codificaciones, esto puede ser más eficaz mediante la eliminación de una copia de los datos.

Sintaxis

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

Parámetros

[in] writer

Puntero al objeto Escritor XML en el que se escriben los bytes. El puntero debe hacer referencia a un WS_XML_WRITER válido y el valor al que se hace referencia no puede ser NULL.

[in] callback

Este parámetro es la devolución de llamada que se va a invocar para escribir los datos.

[in, optional] callbackState

Puntero a un estado definido por el usuario que se pasa a la función de devolución de llamada.

[in, optional] error

Puntero a un objeto WS_ERROR donde se debe almacenar información adicional sobre el error si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
E_INVALIDARG
 Uno o más argumentos no son válidos.
WS_E_INVALID_OPERATION
 No se permite la operación debido al estado actual del objeto .

Comentarios

Al escribir con el WS_XML_WRITER_MTOM_ENCODING, WsPushBytes proporciona una manera de escribir bytes directamente en su propio elemento MIME y evitar una copia. Sin embargo, el escritor a su discreción puede optar por invocar la devolución de llamada inmediatamente, por lo que el autor de la llamada debe estar preparado para ello.

Si la codificación no puede aprovechar este comportamiento, WsPushBytes invocará la devolución de llamada inmediatamente y funcionará como si se llamara a WsWriteBytes .

Requisitos

   
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado webservices.h
Library WebServices.lib
Archivo DLL WebServices.dll