Função WsGetXmlAttribute (webservices.h)

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