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


Метод IStream::Clone (objidl.h)

Метод Clone создает новый объект потока с собственным указателем поиска, который ссылается на те же байты, что и исходный поток.

Синтаксис

HRESULT Clone(
  [out] IStream **ppstm
);

Параметры

[out] ppstm

При успешном выполнении наведите указатель на расположение указателя IStream на новый объект потока. При возникновении ошибки этот параметр имеет значение NULL.

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

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK Поток успешно клонирован.
E_PENDING Только асинхронное хранилище. Часть или все данные потока в настоящее время недоступны.
STG_E_INSUFFICIENTMEMORY Поток не был клонирован из-за нехватки памяти.
STG_E_INVALIDPOINTER Недопустимый указатель ppStm.
STG_E_REVERTED Объект был признан недействительным операцией отменить изменения над ним в дереве транзакций.

Комментарии

Метод Clone создает новый объект потока для доступа к тем же байтам, но с помощью отдельного указателя поиска. Новый объект потока видит те же данные, что и объект source-stream. Изменения, записанные в один объект, сразу же видны в другом. Блокировка диапазона совместно используется объектами потока.

Начальное значение указателя поиска в клонированных экземплярах потока совпадает с текущим параметром указателя поиска в исходном потоке во время операции клонирования.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header objidl.h
Библиотека Uuid.lib
DLL Ole32.dll

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

IStream — реализация составного файла

IStream::CopyTo