Funzione WsReadBytes (webservices.h)

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.

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