WsGetWriterPosition-Funktion (webservices.h)

  • Artikel

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.

Rückgabecode Beschreibung
E_INVALIDARG
 Mindestens ein Argument ist ungültig.

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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile webservices.h
Bibliothek WebServices.lib
DLL WebServices.dll