Share via


Funzione WsReadQualifiedName (webservices.h)

Legge un nome qualificato e lo separa nel prefisso, localName e nello spazio dei nomi in base all'ambito dello spazio dei nomi corrente dell'XML_READER. Se viene specificato il parametro ns, verrà restituito lo spazio dei nomi a cui verrà associato il prefisso oppure WS_E_INVALID_FORMAT verrà restituito. Vedere Valori restituiti da Servizi Web Windows. Le stringhe vengono inserite nell'heap specificato.

Sintassi

HRESULT WsReadQualifiedName(
  [in]           WS_XML_READER *reader,
  [in]           WS_HEAP       *heap,
                 WS_XML_STRING *prefix,
  [out]          WS_XML_STRING *localName,
                 WS_XML_STRING *ns,
  [in, optional] WS_ERROR      *error
);

Parametri

[in] reader

Lettore che deve leggere il nome qualificato.

[in] heap

Heap in cui devono essere allocate le stringhe risultanti.

prefix

Il prefisso del nome qualificato viene restituito qui.

[out] localName

Il nome locale del nome qualificato viene restituito qui.

ns

Lo spazio dei nomi a cui viene associato il nome qualificato viene restituito qui.

[in, optional] error

Se localName manca la funzione restituirà WS_E_INVALID_FORMAT.
Se il parametro ns è specificato, ma il prefisso non è associato a uno spazio dei nomi, WS_E_INVALID_FORMAT verrà restituito.

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.

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