Поделиться через


Метод IPipeByte::P ull (objidl.h)

Извлекает данные типа байтов из источника канала.

Синтаксис

HRESULT Pull(
  [out] BYTE  *buf,
  [in]  ULONG cRequest,
  [out] ULONG *pcReturned
);

Параметры

[out] buf

Указатель на буфер памяти, который получает данные. Буфер должен содержать по крайней мере количество байтов, указанное в cRequest.

[in] cRequest

Количество запрошенных байтов.

[out] pcReturned

Фактическое число возвращаемых байтов.

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

Этот метод возвращает S_OK, чтобы указать, что данные были успешно получены.

Комментарии

При вызове метода Pull данные запрашивается у поставщика канала. Вызывающий объект должен предоставить буфер, который будет содержать по крайней мере количество байтов, указанное в параметре cRequest . Прокси-сервер разархагирует данные в предоставленный буфер и установит количество байтов, фактически предоставленных в pcReturned. Параметр pcReturned может быть меньше или равен cRequest, но он никогда не будет больше. Если pcReturned имеет значение 0, это означает, что больше нет данных.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header objidl.h (включая ObjIdl.h)

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

IPipeByte