funzione IStream_Read (shlwapi.h)

  • Articolo

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)

Vedi anche

ISequentialStream::Read