Funzione WsWriteStartElement (webservices.h)

Articolo
03/13/2024

Scrive un elemento start nel writer.

Dopo aver chiamato questa funzione WsWriteStartAttribute o WsWriteXmlnsAttribute, è possibile chiamare per scrivere attributi aggiuntivi all'elemento. L'elemento non viene eseguito il commit nel writer fino a quando non viene chiamato WsWriteEndElement o altre funzioni che scrivono contenuto.

Sintassi

HRESULT WsWriteStartElement(
  [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, optional] WS_ERROR            *error
);

Parametri

[in] writer

Puntatore all'oggetto WS_XML_WRITER a cui viene scritto l'elemento iniziale. 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.

[in] localName

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

[in] ns

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

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, il writer userà 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_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 la codifica sottostante supporta elementi vuoti e l'elemento non dispone di contenuto, viene scritto un elemento vuoto.

Se viene restituito un prefisso non vuoto con uno spazio dei nomi vuoto WS_E_INVALID_FORMAT .

Se la scrittura dell'elemento iniziale causa il superamento WS_XML_WRITER_PROPERTY_MAX_DEPTH WS_E_QUOTA_EXCEEDED viene restituito. Vedere Valori restituiti da Servizi Web Windows.

Quando si usa WS_XML_WRITER_MTOM_ENCODING si tratta di un errore per tentare di scrivere un elemento con il nome locale "Include" dallo spazio dei nomi"http://www.w3.org/2004/08/xop/include".

WsWriteStartAttribute può essere usato anche per aggiungere un attributo a un elemento quando il writer viene posizionato in un elemento usando WsMoveWriter o WsSetWriterPosition.

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