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