Condividi tramite


Funzione WsWriteCharsUtf8 (webservices.h)

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