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

Метод IFsiDirectoryItem::get__NewEnum (imapi2fs.h)

  • Статья

Извлекает список дочерних элементов, содержащихся в каталоге в образе файловой системы.

Синтаксис

HRESULT get__NewEnum(
  [out] IEnumVARIANT **NewEnum
);

Параметры

[out] NewEnum

Интерфейс IEnumVariant , используемый для перечисления дочерних элементов, содержащихся в каталоге. Элементы перечисления — это варианты с типом VT_BSTR. Используйте элемент bstrVal , чтобы получить путь к дочернему элементу.

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

S_OK возвращается, когда число запрошенных элементов (celt) возвращается успешно или количество возвращенных элементов (pceltFetched) меньше числа запрошенных элементов. Параметры celt и pceltFetched определяются IEnumVariant.

В результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:

Код возврата Описание
E_POINTER
 Недопустимый указатель.

Значение: 0x80004003
E_OUTOFMEMORY
 Не удалось выделить необходимую память.

Значение: 0x8007000E

Комментарии

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

Чтобы получить один элемент, см. свойство IFsiDirectoryItem::get_Item .

Требования

   
Минимальная версия клиента Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header imapi2fs.h

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

IFsiDirectoryItem

IFsiDirectoryItem::get_EnumFsiItems