Compartilhar via

Função WsFindAttribute (webservices.h)

  • Artigo

Pesquisa os atributos do elemento atual em busca de um atributo com o nome e o namespace especificados e retorna seu índice que pode ser passado para WsReadStartAttribute.

Sintaxe

HRESULT WsFindAttribute(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                required,
  [out]          ULONG               *attributeIndex,
  [in, optional] WS_ERROR            *error
);

Parâmetros

[in] reader

O leitor no qual localizar o atributo.

[in] localName

O nome local do atributo a ser pesquisado.

[in] ns

O namespace do atributo a ser pesquisado.

[in] required

Se necessário for TRUE e o atributo não for encontrado, a função retornará WS_E_INVALID_FORMAT. (Consulte Valores retornados dos Serviços Web do Windows.) se necessário for FALSE e o atributo não for encontrado, a função retornará S_FALSE.

[out] attributeIndex

Se o atributo for encontrado, o índice do atributo será retornado aqui. Esse índice pode ser passado para WsReadStartAttribute.

[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
WS_E_INVALID_FORMAT
 Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado.

Comentários

Se o leitor não estiver posicionado em um elemento start, ele retornará WS_E_INVALID_OPERATION. (Consulte Valores retornados dos Serviços Web do Windows.)

O índice retornado não corresponde necessariamente à posição do atributo como apareceu no documento. Ele identifica o índice do atributo correspondente na matriz de atributos do WS_XML_ELEMENT_NODE. A ordem dos atributos nessa matriz pode ser diferente da ordem em que os atributos apareceram no documento.

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