Condividi tramite


Funzione WsReadChars (webservices.h)

Legge un numero specificato di caratteri di testo dal lettore.

Sintassi

HRESULT WsReadChars(
  [in]           WS_XML_READER *reader,
                 WCHAR         *chars,
  [in]           ULONG         maxCharCount,
  [out]          ULONG         *actualCharCount,
  [in, optional] WS_ERROR      *error
);

Parametri

[in] reader

Puntatore al lettore XML da cui devono essere letti i dati dei caratteri. Il puntatore deve fare riferimento a un oggetto WS_XML_READER valido.

chars

Puntatore a una posizione per i caratteri letti.

[in] maxCharCount

Numero massimo di caratteri da leggere.

[out] actualCharCount

Puntatore a un valore ULONG del numero effettivo di caratteri letti. Questo può essere minore di maxCharCount anche quando ci sono più caratteri rimanenti. Non ci sono più caratteri quando questo 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 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 non generato.

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