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

Метод IByteBuffer::Clone

  • Статья

[Метод Clone доступен для использования в операционных системах, указанных в разделе Требования. Он недоступен для использования в Windows Server 2003 с пакетом обновления 1 (SP1) и более поздних версиях, Windows Vista, Windows Server 2008 и последующих версиях операционной системы. Интерфейс IStream предоставляет аналогичные функции.]

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

Синтаксис

HRESULT Clone(
  [out] LPBYTEBUFFER *ppByteBuffer
);

Параметры

ppByteBuffer [out]

При успешном выполнении указывает на расположение указателя IByteBuffer на новый объект потока. Завершив использование указателя IByteBuffer , отпустите его, вызвав функцию IUnknown::Release . Если возникает ошибка, этот параметр имеет значение NULL.

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

Возвращаемое значение — HRESULT. Значение S_OK указывает, что вызов выполнен успешно.

Комментарии

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

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

Примеры

В следующем примере показано клонирование интерфейса IByteBuffer .

HRESULT  hr;

// Clone the buffer.
hr = pIByteBuff->Clone(&pIByteClone);
if (FAILED(hr))
  printf("Failed IByteBuffer::Clone\n");

Требования

Требование Значение
Минимальная версия клиента
 Windows XP [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Окончание поддержки клиентов
 Windows XP
Прекращение поддержки сервера
 Windows Server 2003
Заголовок
Scardssp.h
Библиотека типов
Scardssp.tlb
DLL
Scardssp.dll
IID
 IID_IByteBuffer определяется как E126F8FE-A7AF-11D0-B88A-00C04FD424B9