WsWriteText-Funktion (webservices.h)

Artikel
08/27/2023

Schreibt den angegebenen Text in den XML-Writer.

Rufen Sie WsWriteStartAttribute auf, um Zeichen in einen Attributwert zu schreiben. Nur Leerzeichen dürfen am Stamm eines XML-Dokuments geschrieben werden, es sei denn, die WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT wurde auf TRUE festgelegt.

Syntax

HRESULT WsWriteText(
  [in]           WS_XML_WRITER     *writer,
  [in]           const WS_XML_TEXT *text,
  [in, optional] WS_ERROR          *error
);

Parameter

[in] writer

Ein Zeiger auf das WS_XML_WRITER-Objekt , in das der Text geschrieben wird. Der Zeiger muss auf ein gültiges XML Writer-Objekt verweisen.

[in] text

Ein Zeiger auf den zu schreibenden Text.

Hinweis Weitere Informationen zum Textobjekt finden Sie unter WS_XML_TEXT und den abgeleiteten Klassen.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler 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.

Hinweise

WsWriteText kann zwischen WsWriteStartAttribute und WsWriteEndAttribute nur einmal aufgerufen werden, es sei denn, der Texttyp ist einer der folgenden:

WS_XML_TEXT_TYPE_UTF8
WS_XML_TEXT_TYPE_UTF16
WS_XML_TEXT_TYPE_BASE64

Hinweis Wenn der Text Type auf einen der vorherigen Werte festgelegt ist, kann WsWriteText mehrmals aufgerufen werden. Der Text Type muss jedoch für alle Aufrufe innerhalb eines Attributs identisch sein.

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