Метод IByteBuffer::CopyTo
[Метод CopyTo доступен для использования в операционных системах, указанных в разделе Требования. Он недоступен для использования в Windows Server 2003 с пакетом обновления 1 (SP1) и более поздних версиях, Windows Vista, Windows Server 2008 и последующих версиях операционной системы. Интерфейс IStream предоставляет аналогичные функциональные возможности.]
Метод CopyTo копирует указанное количество байтов из текущего указателя поиска в объекте в текущий указатель поиска в другом объекте.
Синтаксис
HRESULT CopyTo(
[in] LPBYTEBUFFER *pByteBuffer,
[in] LONG cb,
[out] LONG *pcbRead,
[out] LONG *pcbWritten
);
Параметры
-
pByteBuffer [in]
-
Указывает на целевой поток. Поток, на который указывает pByteBuffer , может быть новым потоком или клоном исходного потока.
-
cb [in]
-
Число байтов для копирования из исходного потока.
-
pcbRead [out]
-
Указатель на расположение, в котором этот метод записывает фактическое количество байтов, считанных из источника. Для этого указателя можно задать значение NULL , чтобы указать, что это значение вас не интересует. В этом случае этот метод не предоставляет фактическое число прочитанных байтов.
-
pcbWritten [out]
-
Указатель на расположение, в котором этот метод записывает фактическое количество байтов, записанных в место назначения. Для этого указателя можно задать значение NULL , чтобы указать, что это значение вас не интересует. В этом случае этот метод не предоставляет фактическое число записанных байтов.
Возвращаемое значение
Возвращаемое значение — HRESULT. Значение S_OK указывает, что вызов выполнен успешно.
Комментарии
Этот метод копирует указанные байты из одного потока в другой. Его также можно использовать для копирования потока в себя. Указатель поиска в каждом экземпляре потока корректируется на количество прочитанных или записанных байтов.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows XP [только классические приложения] |
Минимальная версия сервера |
Windows Server 2003 [только классические приложения] |
Окончание поддержки клиентов |
Windows XP |
Окончание поддержки сервера |
Windows Server 2003 |
Заголовок |
|
Библиотека типов |
|
DLL |
|
IID |
IID_IByteBuffer определяется как E126F8FE-A7AF-11D0-B88A-00C04FD424B9 |