Funzione WsWriteStartAttribute (webservices.h)

Articolo
08/27/2023

Questa operazione inizia a scrivere un attributo nell'elemento corrente. WsWriteStartElement deve essere chiamato prima di poter scrivere un attributo. Dopo l'avvio dell'attributo, il valore dell'attributo può essere scritto usando WsWriteChars, WsWriteBytes o WsWriteValue. L'attributo deve essere completato usando WsWriteEndAttribute.

Sintassi

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

Parametri

[in] writer

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

[in, optional] prefix

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

[in] localName

Puntatore WS_XML_STRING al nome locale utilizzato dall'attributo . Deve essere lungo almeno un carattere.

[in] ns

Puntatore WS_XML_STRING allo spazio dei nomi da usare per l'attributo .

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 userà tale prefisso e può includere un attributo XMLNS, se necessario, per eseguire l'override di un prefisso esistente nell'ambito.

[in] singleQuote

Determina se utilizzare una virgoletta singola o doppia per il valore dell'attributo.

Nota Con WS_XML_WRITER_BINARY_ENCODING il carattere 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

Se viene specificato un prefisso NULL , il writer sceglierà un prefisso per lo spazio dei nomi.

Per scrivere un attributo "xml:lang" o "xml:space", specificare "xml" per il prefisso , "lang" o "space" per localName e "http://www.w3.org/XML/1998/namespace" per lo spazio dei nomi .

Se si scrive l'attributo WS_XML_WRITER_PROPERTY_MAX_ATTRIBUTES viene superato, viene restituito WS_E_QUOTA_EXCEEDED .

Se viene specificato un prefisso non vuoto con uno spazio dei nomi vuoto WS_E_INVALID_FORMAT viene restituito . Vedere Valori restituiti di Servizi Web Windows.

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