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)

Confira também

ISequentialStream::Read