WsGetWriterPosition-Funktion (webservices.h)

Gibt die aktuelle Position des Writers zurück. Dies kann nur für einen Writer verwendet werden, der auf einen XmlBuffer festgelegt ist. Beim Schreiben in einen Puffer stellt die Position den XML-Knoten dar, vor dem neue Daten platziert werden.

Syntax

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

Parameter

[in] writer

Der Writer, für den die aktuelle Position abgerufen wird.

[out] nodePosition

Die aktuelle Position des Writers wird hier zurückgegeben.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Hinweise

Weitere Informationen zur Verwendung von Positionen finden Sie unter WS_XML_NODE_POSITION .

Es kann nützlich sein, WsWriteEndStartElement aufzurufen, um das Commit eines Elements zu erzwingen, bevor die Position abgerufen wird.

Anforderungen