funzione IStream_Read (shlwapi.h)
Legge i byte da un flusso specificato e restituisce un valore che indica se tutti i byte sono stati letti correttamente.
Sintassi
LWSTDAPI IStream_Read(
[in] IStream *pstm,
[out] void *pv,
[in] ULONG cb
);
Parametri
[in] pstm
Tipo: IStream*
Puntatore all'interfaccia IStream del flusso da cui leggere.
[out] pv
Tipo: VOID*
Puntatore a un buffer per ricevere i dati del flusso da pstm. Questo buffer deve avere dimensioni di almeno cb byte.
[in] cb
Tipo: ULONG
Numero di byte di dati che la funzione deve tentare di leggere dal flusso di input.
Valore restituito
Tipo: HRESULT
Restituisce S_OK se la funzione legge correttamente il numero specificato di byte dal flusso o un codice di errore COM in caso contrario. In particolare, se il tentativo di lettura ha avuto esito positivo ma è stato letto meno di cb byte, la funzione restituisce E_FAIL.
Commenti
Questa funzione chiama il metodo ISequentialStream::Read per leggere i dati dal flusso specificato nel buffer. Se la funzione ha esito negativo per qualsiasi motivo, il contenuto del buffer di output e la posizione del puntatore di lettura nel flusso di input non sono definiti.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional, Windows XP [solo app desktop] |
| Server minimo supportato | Windows 2000 Server, Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | shlwapi.h |
| DLL | Shlwapi.dll (versione 5.0 o successiva) |