Función WsFindAttribute (webservices.h)

Busca en los atributos del elemento actual un atributo con el nombre y el espacio de nombres especificados y devuelve su índice que se puede pasar a WsReadStartAttribute.

Sintaxis

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

Lector en el que se va a buscar el atributo .

[in] localName

Nombre local del atributo que se va a buscar.

[in] ns

Espacio de nombres del atributo que se va a buscar.

[in] required

Si es necesario es TRUE y no se encuentra el atributo , la función devolverá WS_E_INVALID_FORMAT. (Consulte Valores devueltos de servicios web de Windows). si es necesario es FALSE y no se encuentra el atributo , la función devolverá S_FALSE.

[out] attributeIndex

Si se encuentra el atributo , se devuelve aquí el índice del atributo . A continuación, este índice se puede pasar a WsReadStartAttribute.

[in, optional] error

Especifica dónde se debe almacenar información de error adicional si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto	Descripción
WS_E_INVALID_FORMAT	Los datos de entrada no tenían el formato esperado o no tenían el valor esperado.

Comentarios

Si el lector no está colocado en un elemento de inicio, devolverá WS_E_INVALID_OPERATION. (Consulte Valores devueltos de servicios web de Windows).

El índice devuelto no corresponde necesariamente a la posición del atributo tal como apareció en el documento. Identifica el índice del atributo coincidente en la matriz de atributos del WS_XML_ELEMENT_NODE. El orden de los atributos de esta matriz puede diferir del orden en que aparecieron los atributos en el documento.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	webservices.h
Library	WebServices.lib
Archivo DLL	WebServices.dll