функция IStream_Read (shlwapi.h)

  • Статья

Считывает байты из указанного потока и возвращает значение, указывающее, были ли все байты успешно прочитаны.

Синтаксис

LWSTDAPI IStream_Read(
  [in]  IStream *pstm,
  [out] void    *pv,
  [in]  ULONG   cb
);

Параметры

[in] pstm

Тип: IStream*

Указатель на интерфейс IStream потока, из которого выполняется чтение.

[out] pv

Тип: VOID*

Указатель на буфер для получения данных потока из pstm. Размер этого буфера должен быть не менее кб байт.

[in] cb

Тип: ULONG

Количество байтов данных, которые функция должна пытаться считывать из входного потока.

Возвращаемое значение

Тип: HRESULT

Возвращает S_OK , если функция успешно считывает указанное число байтов из потока, или код сбоя COM в противном случае. В частности, если попытка чтения прошла успешно, но было прочитано меньше кб байт, функция возвращает E_FAIL.

Комментарии

Эта функция вызывает метод ISequentialStream::Read для чтения данных из указанного потока в буфер. Если функция по какой-либо причине завершается сбоем, содержимое выходного буфера и положение указателя чтения во входном потоке не определены.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows 2000 Server, Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shlwapi.h
DLL Shlwapi.dll (версия 5.0 или более поздняя)

См. также раздел

ISequentialStream::Read