Метод IFileSystemImage::ImportFileSystem (imapi2fs.h)
Импортирует файловую систему по умолчанию на текущем диске.
Синтаксис
HRESULT ImportFileSystem(
[out] FsiFileSystems *importedFileSystem
);
Параметры
[out] importedFileSystem
Определяет импортированную файловую систему. Возможные значения см. в разделе Тип перечисления FsiFileSystems .
Возвращаемое значение
S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:
| Код возврата | Описание |
|---|---|
|
Недопустимый указатель.
Значение: 0x80004003 |
|
Перед вызовом этого метода необходимо задать свойство MultisessionInterfaces.
Значение: 0xC0AAB15D |
|
Оптический носитель пуст.
Значение: 0xC0AAB150 |
|
Указанный диск не содержит одну из поддерживаемых файловых систем.
Значение: 0xC0AAB151 Примечание Файловые системы, скорее всего, поддерживаются для этой операции, но на низких уровнях IMAPI2 при вызове ImportFileSystem она имеет универсальную обработку исключений и ошибок и сообщает об ошибках 0xC0AAB151. Если диск не получен для монопольного доступа или иным образом запрещен доступ, эта ошибка не будет сообщена.
|
|
Загрузочный объект может быть включен только в начальный образ диска.
Значение: 0xC0AAB149 |
|
Не удалось выделить необходимую память.
Значение: 0x8007000E |
|
Значение, указанное для свойства FreeMediaBlocks, слишком мало для предполагаемого размера изображения на основе текущих данных.
Значение: 0xC0AAB121 |
|
Недопустимое значение параметра %1!ls! .
Значение: 0xC0AAB101 |
|
IMAPI не поддерживает ни один из типов мультисессии, предоставляемых на текущем носителе.
Значение: 0xC0AAB15C Примечание. Метод IFileSystemImage::ImportFileSystem возвращает эту ошибку, если на устройстве записи нет носителя.
|
|
Операция завершилась сбоем из-за несовместимого макета предыдущего сеанса, импортированного из среды.
Значение: 0xC0AAB133 |
Комментарии
Необходимо вызвать IFileSystemImage::p ut_MultisessionInterfaces перед вызовом IFileSystemImage::ImportFileSystem. Кроме того, рекомендуется вызывать IDiscFormat2::get_MediaHeuristicallyBlank перед IFileSystemImage::p ut_MultisessionInterfaces , чтобы убедиться, что носитель не пуст.
Если диск содержит несколько файловых систем, импортируется только одна файловая система. Этот метод выбирает файловую систему для импорта в следующем порядке: UDF, Joliet, ISO 9660. Импорт включает передачу каталогов и файлов в структуру файловой системы в памяти.
Этот метод можно вызвать в любое время во время создания файловой системы в памяти. Если во время импорта файл или каталог уже существует в копии в памяти, версия в памяти будет сохранена; импортированный файл будет удален.
Чтобы определить, какая файловая система является файловой системой по умолчанию для диска, вызовите метод IFileSystemImage::GetDefaultFileSystemForImport .
Этот метод считывает только сведения о файле. Если элемент является файлом, данные файла копируются при вызове метода IFsiDirectoryItem::AddFile, IFsiDirectoryItem::AddTree или IFsiDirectoryItem::Add .
Этот метод возвращает IMAPI_E_NO_SUPPORTED_FILE_SYSTEM , если поддерживаемая файловая система не найдена в последнем сеансе. Кроме того, этот метод возвращает IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION , если макет файловой системы в последнем сеансе несовместим с макетом, используемым IMAPI для создания запрошенных файловых систем для результирующих образов. Дополнительные сведения см. в документации по методу IFileSystemImage::p ut_FileSystemsToCreate .
Требования
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | imapi2fs.h |