Funzione WsGetXmlAttribute (webservices.h)

Trova l'attributo xml più vicino nell'ambito con il nome locale specificato e restituisce il relativo valore.
Il valore restituito viene inserito nell'heap specificato.

Sintassi

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

Parametri

[in] reader

Lettore per il quale verrà eseguito la ricerca dell'attributo xml.

[in] localName

LocalName dell'attributo xml per cui eseguire la ricerca.

[in] heap

Heap in cui deve essere allocato il valore risultante.

valueChars

Il valore dell'attributo viene archiviato qui.

[out] valueCharCount

Lunghezza del valoreChars.

[in, optional] error

Specifica la posizione in cui devono essere archiviate informazioni aggiuntive sugli errori se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
E_INVALIDARG	Uno o più argomenti non sono validi.
S_FALSE	L'attributo xml non è stato trovato.

Commenti

Questa funzione può essere usata solo per ottenere i valori degli attributi nell'ambito che usano il prefisso "xml".

Se non viene trovato alcun attributo xml corrispondente, verrà restituita una stringa di lunghezza zero per il valore e la funzione restituisce S_FALSE.

Il lettore non esegue alcuna operazione con attributi xml diversi da quello di superficie per l'ispezione.

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