Funzione WsGetWriterPosition (webservices.h)

Articolo
03/03/2024

Restituisce la posizione corrente del writer. Questa opzione può essere utilizzata solo in un writer impostato su xmlBuffer. Quando si scrive in un buffer, la posizione rappresenta il nodo xml prima del quale verranno inseriti nuovi dati.

Sintassi

HRESULT WsGetWriterPosition(
  [in]           WS_XML_WRITER        *writer,
  [out]          WS_XML_NODE_POSITION *nodePosition,
  [in, optional] WS_ERROR             *error
);

Parametri

[in] writer

Writer per il quale verrà ottenuta la posizione corrente.

[out] nodePosition

La posizione corrente del writer viene restituita qui.

[in, optional] error

Specifica dove archiviare 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.

Commenti

Per altre informazioni sull'uso delle posizioni, vedere WS_XML_NODE_POSITION.

Può essere utile chiamare WsWriteEndStartElement per forzare il commit di un elemento prima di ottenere la posizione.

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