Funzione WsWriteXmlnsAttribute (webservices.h)

Articolo
03/03/2024

Scrive un attributo Xmlns nell'elemento corrente. WsWriteStartElement deve essere chiamato prima che sia possibile scrivere un attributo e se il numero di attributi supera il numero massimo di attributi consentiti per il writer, la funzione restituisce WS_E_QUOTA_EXCEEDED. Vedere Valori restituiti da Servizi Web Windows.

Sintassi

HRESULT WsWriteXmlnsAttribute(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                singleQuote,
  [in, optional] WS_ERROR            *error
);

Parametri

[in] writer

Puntatore all'oggetto WS_XML_WRITER a cui viene scritto l'attributo Xmlns. Il puntatore deve fare riferimento a un oggetto Writer XML valido.

[in, optional] prefix

Puntatore WS_XML_STRING al prefisso da usare per l'elemento iniziale. Se il valore a cui fa riferimento questo parametro è NULL , il writer sceglierà un attributo.

Specifica il prefisso da usare per l'attributo xmlns.

[in] ns

Puntatore WS_XML_STRING allo spazio dei nomi da associare al prefisso.

[in] singleQuote

Determina se usare una singola o una citazione doppia per il valore dell'attributo.

Nota Se WS_XML_WRITER_BINARY_ENCODING è impostato il carattere di virgolette non viene mantenuto e questo parametro non ha alcun effetto.

[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_OPERATION	L'operazione non è consentita a causa dello stato corrente dell'oggetto.
WS_E_INVALID_FORMAT	I dati di input non erano nel formato previsto o non hanno il valore previsto.
WS_E_QUOTA_EXCEEDED	È stata superata una quota.

Commenti

Si applicano le condizioni seguenti:

Se viene specificato un prefisso vuoto, viene assegnato lo spazio dei nomi predefinito.
Se viene specificato un prefisso NULL , il writer sceglie il prefisso appropriato per lo spazio dei nomi.
Se l'attributo Xmlns è ridondante non può essere scritto.
Se viene restituito un prefisso non vuoto con uno spazio dei nomi vuoto WS_E_INVALID_FORMAT .

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

Share via