Share via

Função WsGetXmlAttribute (webservices.h)

  • Artigo

Localiza o atributo xml mais próximo no escopo com o localName especificado e retorna seu valor.
O valor retornado é colocado no heap especificado.

Sintaxe

HRESULT WsGetXmlAttribute(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           WS_HEAP             *heap,
                 WCHAR               **valueChars,
  [out]          ULONG               *valueCharCount,
  [in, optional] WS_ERROR            *error
);

Parâmetros

[in] reader

O leitor para o qual o atributo xml será pesquisado.

[in] localName

O localName do atributo xml para o qual pesquisar.

[in] heap

O heap no qual o valor resultante deve ser alocado.

valueChars

O valor do atributo é armazenado aqui.

[out] valueCharCount

O comprimento do valueChars.

[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.
S_FALSE
 O atributo xml não foi encontrado.

Comentários

Essa função só pode ser usada para obter os valores de atributos no escopo que usam o prefixo "xml".

Se nenhum atributo xml correspondente for encontrado, uma cadeia de caracteres de comprimento zero será retornada para o valor e a função retornará S_FALSE.

O leitor não faz nada com atributos xml além de exibi-los para inspeção.

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