WsWriteChars-Funktion (webservices.h)

Artikel
08/27/2023

Schreibt eine Reihe von Zeichen in ein Element oder Attribut.

Um Zeichen in einen Attributwert zu schreiben, rufen Sie zuerst WsWriteStartAttribute auf. Im Stammverzeichnis eines XML-Dokuments dürfen nur Leerzeichen geschrieben werden, es sei denn, die WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT wurde auf TRUE festgelegt.

Syntax

HRESULT WsWriteChars(
  [in]           WS_XML_WRITER *writer,
                 const WCHAR   *chars,
  [in]           ULONG         charCount,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] writer

Ein Zeiger auf das WS_XML_WRITER-Objekt , in das die Zeichen geschrieben werden. Der Zeiger muss auf ein gültiges XML Writer-Objekt verweisen.

chars

Ein Zeiger auf die zu schreibenden Zeichen.

[in] charCount

Die Anzahl der zu schreibenden Zeichen.

[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

WsWriteChars kann zwischen WsWriteStartAttribute und WsWriteEndAttribute mehrmals aufgerufen werden. Sie kann beim Schreiben eines Attributs nicht mit WsWriteCharsUtf8, WsWriteBytes, WsWriteValue oder WsWriteText kombiniert werden.

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