Compartilhar via

Função WsWriteBytes (webservices.h)

  • Artigo

Grava bytes no gravador em um formato otimizado para a codificação. Ao gravar em uma codificação de texto, ele emitirá os bytes codificados em base64. Ao gravar em um formato binário, ele emitirá os bytes diretamente.

Sintaxe

HRESULT WsWriteBytes(
  [in]           WS_XML_WRITER *writer,
                 const void    *bytes,
  [in]           ULONG         byteCount,
  [in, optional] WS_ERROR      *error
);

Parâmetros

[in] writer

O gravador ao qual os bytes serão escritos.

bytes

Os bytes a serem gravados no documento.

[in] byteCount

O número de bytes a serem gravados no documento.

[in, optional] error

Especifica onde informações adicionais de erro devem ser armazenadas se a função falhar.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
E_INVALIDARG
 Um ou mais argumentos são inválidos.
WS_E_INVALID_OPERATION
 A operação não é permitida devido ao estado atual do objeto.
WS_E_QUOTA_EXCEEDED
 Uma cota foi excedida.

Comentários

WsWriteBytes pode ser chamado mais de uma vez entre WsWriteStartAttribute e WsWriteEndAttribute. Ele pode não ser combinado com WsWriteChars, WsWriteCharsUtf8, WsWriteValue ou WsWriteText ao escrever um atributo.

Para o WS_XML_WRITER_MTOM_ENCODING, se byteCount exceder o maxInlineByteCount especificado durante WsSetOutput , os bytes serão armazenados em buffer e colocados em sua própria parte MIME. Caso contrário, os bytes são codificados em base64 e colocados diretamente no documento.

Para o WS_XML_WRITER_MTOM_ENCODING, se o elemento que contém os bytes tiver um atributo com o nome 'contentType' e o namespace 'http://www.w3.org/2004/11/xmlmime', o valor do atributo será refletido no cabeçalho do tipo de conteúdo para a parte MIME, conforme descrito em Empacotamento Otimizado XML-binary.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho webservices.h
Biblioteca WebServices.lib
DLL WebServices.dll