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

Статья
08/24/2023

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

Синтаксис

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

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