função IStream_Read (shlwapi.h)
Lê bytes de um fluxo especificado e retorna um valor que indica se todos os bytes foram lidos com êxito.
Sintaxe
LWSTDAPI IStream_Read(
[in] IStream *pstm,
[out] void *pv,
[in] ULONG cb
);
Parâmetros
[in] pstm
Tipo: IStream*
Um ponteiro para a interface IStream do fluxo do qual ler.
[out] pv
Tipo: VOID*
Um ponteiro para um buffer para receber os dados de fluxo do pstm. Esse buffer deve ter pelo menos bytes cb em tamanho.
[in] cb
Tipo: ULONG
O número de bytes de dados que a função deve tentar ler do fluxo de entrada.
Retornar valor
Tipo: HRESULT
Retorna S_OK se a função ler com êxito o número especificado de bytes do fluxo ou um código de falha COM caso contrário. Em particular, se a tentativa de leitura foi bem-sucedida, mas menos bytes cb foram lidos, a função retorna E_FAIL.
Comentários
Essa função chama o método ISequentialStream::Read para ler dados do fluxo especificado para o buffer. Se a função falhar por qualquer motivo, o conteúdo do buffer de saída e a posição do ponteiro de leitura no fluxo de entrada serão indefinidos.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server, Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | shlwapi.h |
| DLL | Shlwapi.dll (versão 5.0 ou posterior) |