Funzione WsFindAttribute (webservices.h)

Articolo
03/03/2024

Cerca negli attributi dell'elemento corrente un attributo con il nome e lo spazio dei nomi specificati e restituisce il relativo indice che può essere passato a WsReadStartAttribute.

Sintassi

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
);

Parametri

[in] reader

Lettore in cui trovare l'attributo.

[in] localName

Nome locale dell'attributo da cercare.

[in] ns

Spazio dei nomi dell'attributo da cercare.

[in] required

Se obbligatorio è TRUE e l'attributo non viene trovato, la funzione restituirà WS_E_INVALID_FORMAT. Vedere Valori restituiti di Servizi Web Windows. se obbligatorio è FALSE e l'attributo non viene trovato, la funzione restituirà S_FALSE.

[out] attributeIndex

Se l'attributo viene trovato, l'indice dell'attributo viene restituito qui. Questo indice può quindi essere passato a WsReadStartAttribute.

[in, optional] error

Specifica dove archiviare informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
WS_E_INVALID_FORMAT	I dati di input non erano nel formato previsto o non hanno il valore previsto.

Commenti

Se il lettore non è posizionato su un elemento iniziale, restituirà WS_E_INVALID_OPERATION. Vedere Valori restituiti di Servizi Web Windows.

L'indice restituito non corrisponde necessariamente alla posizione dell'attributo visualizzato nel documento. Identifica l'indice dell'attributo corrispondente nella matrice di attributi del WS_XML_ELEMENT_NODE. L'ordine degli attributi in questa matrice può differire dall'ordine in cui gli attributi sono visualizzati nel documento.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Condividi tramite