Share via

Função WsWriteXmlBufferToBytes (webservices.h)

  • Artigo

Usa um gravador para converter um WS_XML_BUFFER em um conjunto codificado de bytes.

Sintaxe

HRESULT WsWriteXmlBufferToBytes(
  [in]           WS_XML_WRITER                *writer,
  [in]           WS_XML_BUFFER                *xmlBuffer,
  [in, optional] const WS_XML_WRITER_ENCODING *encoding,
                 const WS_XML_WRITER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
  [in]           WS_HEAP                      *heap,
                 void                         **bytes,
  [out]          ULONG                        *byteCount,
  [in, optional] WS_ERROR                     *error
);

Parâmetros

[in] writer

O gravador a ser usado para gerar os bytes codificados.

[in] xmlBuffer

O buffer XML a ser gravado.

[in, optional] encoding

A codificação a ser usada ao gerar os bytes. Se NULL, os bytes serão codificados em utf8.

properties

Uma matriz de propriedades opcionais do gravador. Consulte WS_XML_WRITER_PROPERTY.

[in] propertyCount

O número de propriedades.

[in] heap

O heap do qual alocar os bytes.

bytes

Os bytes gerados são retornados aqui.

[out] byteCount

O número de bytes gerados é retornado aqui.

[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

A função gerará todo o conteúdo do WS_XML_BUFFER como um conjunto linear de bytes alocados do heap especificado na codificação especificada.

O gravador será deixado em um estado indefinido depois de chamar essa função. No entanto, WsWriteXmlBufferToBytes pode ser usado novamente com esse gravador. Caso contrário, WsSetOutput ou WsSetOutputToBuffer devem ser usados para trazer o gravador de volta a um estado conhecido ou o gravador deve ser liberado usando WsFreeWriter.

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