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

Статья
02/29/2024

Создает новый перечислитель с тем же состоянием перечисления, что и текущий.

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

Синтаксис

HRESULT Clone(
  [out] IEnumSTATDATA **ppenum
);

Параметры

[out] ppenum

Указатель на переменную указателя IEnumSTATDATA , которая получает указатель интерфейса на объект перечисления. Если метод завершается неудачно, значение этой выходной переменной не определено.

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

Этот метод возвращает значение S_OK при успешном завершении. Ниже перечислены другие возможные значения.

Код возврата	Описание
E_UNEXPECTED	Произошла непредвиденная ошибка.
E_INVALIDARG	Указанный перечислитель недопустим.
E_OUTOFMEMORY	Недостаточно доступной памяти для этой операции.

Требования

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

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

IEnumSTATDATA

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