Funzione WsReadCharsUtf8 (webservices.h)

Articolo
08/27/2023

Legge un numero specificato di caratteri di testo dal lettore e li restituisce codificati in UTF-8.

Sintassi

HRESULT WsReadCharsUtf8(
  [in]           WS_XML_READER *reader,
                 BYTE          *bytes,
  [in]           ULONG         maxByteCount,
  [out]          ULONG         *actualByteCount,
  [in, optional] WS_ERROR      *error
);

Parametri

[in] reader

Puntatore al lettore XML da cui leggere i dati di tipo carattere. Il puntatore deve fare riferimento a un oggetto WS_XML_READER valido.

bytes

Puntatore al buffer in cui inserire i byte codificati letti.

[in] maxByteCount

Numero massimo di byte da leggere.

[out] actualByteCount

Puntatore a un valore ULONG del numero effettivo di byte letti. Questo valore può essere inferiore a maxByteCount anche quando sono presenti più byte rimanenti. Non ci sono più byte quando restituisce zero.

[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
WS_E_INVALID_FORMAT	I dati di input non erano nel formato previsto o non hanno il valore previsto.
WS_E_QUOTA_EXCEEDED	È stata superata una quota.

Commenti

Il testo XML viene letto fino a un elemento iniziale o a un elemento finale. I commenti vengono ignorati e il contenuto CDATA viene trattato in modo identico al contenuto dell'elemento. Le entità carattere vengono convertite nel formato senza caratteri di escape.

Questa funzione può non riuscire per uno dei motivi elencati in WsReadNode.

Requisiti

Requisito	Valore
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

Condividi tramite