Funzione WsWriteQualifiedName (webservices.h)

Articolo
08/27/2023

Scrive un nome completo XML nel writer.

Sintassi

HRESULT WsWriteQualifiedName(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *localName,
  [in, optional] const WS_XML_STRING *ns,
  [in, optional] WS_ERROR            *error
);

Parametri

[in] writer

Puntatore all'oggetto WS_XML_WRITER in cui viene scritto il nome completo. Il puntatore deve fare riferimento a un oggetto Writer XML valido.

[in, optional] prefix

Puntatore WS_XML_STRING al prefisso utilizzato dal nome completo. Se il valore a cui fa riferimento questo parametro è NULL , il writer sceglierà un prefisso.

[in] localName

Puntatore WS_XML_STRING al nome locale utilizzato dal nome completo. Deve essere lungo almeno un carattere.

[in, optional] ns

Puntatore WS_XML_STRING allo spazio dei nomi utilizzato per il nome completo.

Se non viene specificato alcun prefisso, il writer può usare un prefisso nell'ambito associato allo spazio dei nomi specificato oppure può generare un prefisso e includere un attributo XMLNS.

Se viene specificato un prefisso, writer usa tale prefisso e può includere un attributo XMLNS, se necessario, per eseguire l'override di un prefisso esistente nell'ambito.

[in, optional] error

Puntatore a un oggetto WS_ERROR in cui devono essere archiviate informazioni aggiuntive sull'errore 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.
WS_E_INVALID_FORMAT	I dati di input non erano nel formato previsto o non hanno il valore previsto.

Commenti

Se il prefisso è NULL, lo spazio dei nomi non deve essere NULL. In questo caso il writer tenterà di trovare un prefisso nell'ambito associato allo spazio dei nomi specificato. Se viene trovato un prefisso appropriato, verrà usato. Se non il writer genererà un prefisso e inserirà un attributo XMLNS nell'elemento corrente. Se il writer non si trova in un elemento, la funzione restituirà WS_E_INVALID_FORMAT.
Vedere Valori restituiti di Servizi Web Windows.

Se il prefisso non è NULL e lo spazio dei nomi non è NULL , il writer verificherà che il prefisso sia attualmente associato allo spazio dei nomi specificato e restituirà WS_E_INVALID_FORMAT in caso contrario.
Se il prefisso non è NULL e lo spazio dei nomi è NULL , il writer userà il prefisso e il nome locale per scrivere il nome completo.

Requisiti


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