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

Метод IFileSystemImage::ImportSpecificFileSystem (imapi2fs.h)

  • Статья

Импорт определенной файловой системы с диска.

Синтаксис

HRESULT ImportSpecificFileSystem(
  [in] FsiFileSystems fileSystemToUse
);

Параметры

[in] fileSystemToUse

Определяет файловую систему для импорта. Возможные значения см. в разделе Тип перечисления FsiFileSystems .

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

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

Код возврата Описание
IMAPI_E_INVALID_PARAM
 Недопустимое значение параметра %1!ls! .

Значение: 0xC0AAB101
IMAPI_E_MULTISESSION_NOT_SET
 Перед вызовом этого метода необходимо задать свойство MultisessionInterfaces.

Значение: 0xC0AAB15D
IMAPI_E_BOOT_OBJECT_CONFLICT
 Загрузочный объект может быть включен только в начальный образ диска.

Значение: 0xC0AAB149
IMAPI_E_EMPTY_DISC
 Оптический носитель пуст.

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

Значение: 0x8007000E
IMAPI_E_NO_COMPATIBLE_MULTISESSION_TYPE
 IMAPI не поддерживает ни один из типов мультисессии, предоставляемых на текущем носителе.

Значение: 0xC0AAB15C

Примечание. Метод IFileSystemImage::ImportFileSystem возвращает эту ошибку, если на устройстве записи нет носителя.
 
IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION
 Операция завершилась сбоем из-за несовместимого макета предыдущего сеанса, импортированного из среды.

Значение: 0xC0AAB133
IMAPI_E_FILE_SYSTEM_NOT_FOUND
 Указанный диск не содержит "%1!ls!" .

Значение: 0xC0AAB152
IMAPI_E_INVALID_PATH
 Файловая система, указанная для импорта, содержит недопустимое имя файла.

Значение: 0xC0AAB110

Комментарии

Необходимо вызвать IFileSystemImage::p ut_MultisessionInterfaces перед вызовом IFileSystemImage::ImportSpecificFileSystem. Кроме того, рекомендуется вызывать IDiscFormat2::get_MediaHeuristicallyBlank перед IFileSystemImage::p ut_MultisessionInterfaces , чтобы убедиться, что носитель не пуст.

Этот метод можно вызвать в любое время во время создания файловой системы в памяти. Если во время импорта файл или каталог уже существует в копии в памяти, версия в памяти будет сохранена; импортированный файл будет удален.

На повторно записываемом носителе (DVD+/-RW, DVDRAM, BD-RE) импорт или запись второго сеанса не поддерживается, если первый сеанс имеет файловую систему ISO9660 из-за ограничений файловой системы.

Этот метод считывает только сведения о файле. Если элемент является файлом, данные файла копируются при вызове метода IFsiDirectoryItem::AddFile, IFsiDirectoryItem::AddTree или IFsiDirectoryItem::Add .

Этот метод возвращает IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION , если макет файловой системы в последнем сеансе несовместим с макетом, используемым IMAPI для создания запрошенных файловых систем для результирующих образов. Дополнительные сведения см. в документации по методу IFileSystemImage::p ut_FileSystemsToCreate . Если файловая система, указанная параметром fileSystemToUse , не найдена, этот метод возвращает IMAPI_E_FILE_SYSTEM_NOT_FOUND.

Требования

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

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

IFileSystemImage