WsWriteEndStartElement-Funktion (webservices.h)

Artikel
08/27/2023

Erzwingt den Writer, das aktuelle Element zu commiten und zu verhindern, dass weitere Attribute in das Element geschrieben werden.

Syntax

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

Parameter

[in] writer

Der Writer, für den das aktuelle Element committet werden soll.

[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.
WS_E_INVALID_OPERATION	Der Vorgang ist aufgrund des aktuellen Zustands des Objekts nicht zulässig.
WS_E_INVALID_FORMAT	Die Eingabedaten waren nicht im erwarteten Format oder hatten nicht den erwarteten Wert.
WS_E_QUOTA_EXCEEDED	Ein Kontingent wurde überschritten.

Hinweise

Gelegentlich ist es nützlich, die Vervollständigung eines Elements explizit zu erzwingen. Dies kann verwendet werden, um zu erzwingen, dass der Writer ein vollständiges Element und ein Paar schreibt. Dies kann auch beim Abrufen von Positionen nützlich sein, wenn Sie an eine WS_XML_BUFFER schreiben.

Wenn diese API aufgerufen wird, wenn kein Element zum Commit vorhanden ist, wird WS_E_INVALID_OPERATION zurückgegeben. (Siehe Rückgabewerte für Windows-Webdienste.)

Anforderungen


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

Freigeben über