WsWriteCharsUtf8-Funktion (webservices.h)

Schreibt eine Reihe von Zeichen, die als UTF-8 codiert sind, in ein Element oder Attribut. Um Zeichen in einen Attributwert zu schreiben, rufen Sie zuerst WsWriteStartAttribute auf. 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 WsWriteCharsUtf8(
  [in]           WS_XML_WRITER *writer,
                 const BYTE    *bytes,
  [in]           ULONG         byteCount,
  [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.

bytes

Ein Zeiger auf die codierten UTF-8-Zeichen, die geschrieben werden sollen.

[in] byteCount

Die Anzahl der zu schreibenden Bytes.

[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.

Hinweise

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

Anforderungen