Compartilhar via

Função WsReadXmlBufferFromBytes (webservices.h)

  • Artigo

Usa um leitor para converter um conjunto de bytes codificados em um WS_XML_BUFFER.

Sintaxe

HRESULT WsReadXmlBufferFromBytes(
  [in]           WS_XML_READER                *reader,
  [in, optional] const WS_XML_READER_ENCODING *encoding,
                 const WS_XML_READER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 const void                   *bytes,
  [in]           ULONG                        byteCount,
  [in]           WS_HEAP                      *heap,
                 WS_XML_BUFFER                **xmlBuffer,
  [in, optional] WS_ERROR                     *error
);

Parâmetros

[in] reader

O leitor a ser usado para analisar os bytes codificados.

[in, optional] encoding

A codificação a ser usada ao analisar os bytes. Se FOR NULL, um WS_XML_READER_TEXT_ENCODING com um conjunto de caracteres de WS_CHARSET_AUTO será usado.

properties

Uma matriz de propriedades opcionais do leitor. Confira WS_XML_READER_PROPERTY.

[in] propertyCount

O número de propriedades.

bytes

Os bytes a serem analisados.

[in] byteCount

O número de bytes a serem analisados.

[in] heap

O heap do qual alocar o buffer XML.

xmlBuffer

O buffer XML no qual os bytes foram lidos é 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 analisará todo o conteúdo de acordo com a codificação especificada e a armazenará em um WS_XML_BUFFER.

O leitor será deixado em um estado indefinido depois de chamar essa função. No entanto, WsReadXmlBufferFromBytes pode ser usado novamente com esse leitor. Caso contrário, WsSetInput ou WsSetInputToBuffer devem ser usados para trazer o leitor de volta para um estado conhecido ou o leitor deve ser liberado usando WsFreeReader.

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