Метод 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) |