Funzione WsWriteCharsUtf8 (webservices.h)

Articolo
08/27/2023

Scrive una serie di caratteri codificati come UTF-8 in un elemento o attributo. Per scrivere caratteri in un valore di attributo, chiamare prima WsWriteStartAttribute . Solo i caratteri di spazi vuoti possono essere scritti nella radice di un documento xml, a meno che il WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT non sia stato impostato su TRUE.

Sintassi

HRESULT WsWriteCharsUtf8(
  [in]           WS_XML_WRITER *writer,
                 const BYTE    *bytes,
  [in]           ULONG         byteCount,
  [in, optional] WS_ERROR      *error
);

Parametri

[in] writer

Puntatore all'oggetto WS_XML_WRITER a cui vengono scritti i caratteri. Il puntatore deve fare riferimento a un oggetto Writer XML valido.

bytes

Puntatore ai caratteri UTF-8 codificati da scrivere.

[in] byteCount

Numero di byte da scrivere.

[in, optional] error

Puntatore a un oggetto WS_ERROR in cui devono essere archiviate informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
E_INVALIDARG	Uno o più argomenti non sono validi.
WS_E_INVALID_OPERATION	L'operazione non è consentita a causa dello stato corrente dell'oggetto.

Commenti

WsWriteCharsUtf8 può essere chiamato più volte tra WsWriteStartAttribute e WsWriteEndAttribute. Non può essere combinato con WsWriteChars, WsWriteBytes, WsWriteValue o WsWriteText durante la scrittura di un attributo.

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Share via