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


Метод IStringTable::Enumerate (mmc.h)

Метод IStringTable::Enumerate предоставляет указатель на интерфейс IEnumString в перечислителе, который может возвращать строки в строковой таблице оснастки. Интерфейс IEnumString является стандартным COM-интерфейсом.

Синтаксис

HRESULT Enumerate(
  [out] IEnumString **ppEnum
);

Параметры

[out] ppEnum

Адрес переменной указателя IEnumString*, которая получает указатель интерфейса на перечислитель. При возникновении ошибки параметру *ppEnum присваивается значение NULL. Если значение *ppEnum не равно NULL, реализация IEnumString в MMC вызывает IUnknown::AddRef для *ppEnum. Оснастка должна вызывать IUnknown::Release , если интерфейс больше не требуется.

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

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

Комментарии

Возвращенное перечисление IEnumString представляет snapshot коллекции строк в базовой строковой таблице на время извлечения перечисления. Ни IEnumString::Reset, ни IEnumString::Clone не принимают новый snapshot коллекции.

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

Требования

   
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header mmc.h
DLL Mmcndmgr.dll

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

IStringTable

IStringTable::FindString