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

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

  • Статья

Извлекает указанный каталог или элемент файла из образа файловой системы.

Синтаксис

HRESULT get_Item(
  [in]  BSTR     path,
  [out] IFsiItem **item
);

Параметры

[in] path

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

[out] item

Интерфейс IFsiItem запрошенного каталога или элемента файла.

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

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

Код возврата Описание
IMAPI_E_INVALID_PATH
 Путь "%1!s!" имеет неправильный формат или содержит недопустимые символы.

Значение: 0xC0AAB110
E_POINTER
 Недопустимый указатель.

Значение: 0x80004003
IMAPI_E_INVALID_PARAM
 Недопустимое значение параметра %1!ls! .

Значение: 0xC0AAB101
IMAPI_E_ITEM_NOT_FOUND
 Не удается найти элемент %1!ls! в иерархии FileSystemImage.

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

Значение: 0x8007000E

Комментарии

Чтобы определить, является ли элемент элементом файла или элементом каталога, вызовите метод IFsiItem::QueryInterface , передав __uuidof(IFsiDirectoryItem) в качестве идентификатора интерфейса. Если вызов выполнен успешно, элемент является элементом каталога; В противном случае элемент является элементом файла.

Чтобы перечислить все дочерние элементы, вызовите метод IFsiDirectoryItem::get__NewEnum .

Требования

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

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

IFsiDirectoryItem

IFsiFileItem