Funzione WsReadBytes (webservices.h)

Articolo
08/27/2023

Legge il testo dal lettore e decodifica i caratteri come byte in base alla specifica base64.

Sintassi

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

Parametri

[in] reader

Puntatore al lettore XML da cui leggere i byte. Il puntatore deve fare riferimento a un oggetto WS_XML_READER valido.

bytes

Puntatore a una posizione in cui inserire i byte decodificati.

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

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

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

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

Condividi tramite