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


Метод IPipeByte::P ull (objidlbase.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 objidlbase.h (включая ObjIdl.h)

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

IPipeByte