Funzione WsWriteEndStartElement (webservices.h)

Articolo
08/27/2023

Forza il writer a eseguire il commit dell'elemento corrente e impedire la scrittura di altri attributi all'elemento.

Sintassi

HRESULT WsWriteEndStartElement(
  [in]           WS_XML_WRITER *writer,
  [in, optional] WS_ERROR      *error
);

Parametri

[in] writer

Writer per il quale deve essere eseguito il commit dell'elemento corrente.

[in, optional] error

Specifica la posizione in cui devono essere archiviate informazioni aggiuntive sugli errori 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

Occasionalmente, è utile forzare in modo esplicito il completamento di un elemento. Questo può essere usato per forzare il writer a scrivere un elemento completo e una coppia. Può essere utile anche quando si ottengono posizioni quando si scrive in un WS_XML_BUFFER.

La chiamata a questa API quando non è presente alcun elemento da eseguire il commit causerà la restituzione di WS_E_INVALID_OPERATION. Vedere Valori restituiti da Servizi Web Windows.

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