IFileSystemImage::ImportFileSystem 메서드(imapi2fs.h)
현재 디스크에서 기본 파일 시스템을 가져옵니다.
구문
HRESULT ImportFileSystem(
[out] FsiFileSystems *importedFileSystem
);
매개 변수
[out] importedFileSystem
가져온 파일 시스템을 식별합니다. 가능한 값은 FsiFileSystems 열거형 형식을 참조하세요.
반환 값
S_OK 성공에 따라 반환되지만 구현의 결과로 다른 성공 코드가 반환될 수 있습니다. 다음 오류 코드는 일반적으로 작업 실패 시 반환되지만 가능한 오류 값만 나타내지 않습니다.
| 반환 코드 | 설명 |
|---|---|
|
포인터가 잘못되었습니다.
값: 0x80004003 |
|
MultisessionInterfaces 속성은 이 메서드를 호출하기 전에 설정해야 합니다.
값: 0xC0AAB15D |
|
광학 미디어가 비어 있습니다.
값: 0xC0AAB150 |
|
지정된 디스크에는 지원되는 파일 시스템 중 하나가 포함되어 있지 않습니다.
값: 0xC0AAB151 참고 파일 시스템은 작업에 대해 지원될 가능성이 높지만, ImportFileSystem을 호출할 때 하위 수준인 IMAPI2에서는 일반적인 예외/오류 처리가 있으며 오류 0xC0AAB151 다시 보고합니다. 단독 액세스를 위해 디스크를 획득하지 않았거나 액세스가 거부된 경우 이 오류가 보고되지 않습니다.
|
|
부팅 개체는 초기 디스크 이미지에만 포함될 수 있습니다.
값: 0xC0AAB149 |
|
필요한 메모리를 할당하지 못했습니다.
값: 0x8007000E |
|
FreeMediaBlocks 속성에 지정된 값이 너무 작아 현재 데이터에 따라 예상 이미지 크기가 너무 작습니다.
값: 0xC0AAB121 |
|
%1!ls! 매개 변수에 지정된 값이 잘못되었습니다.
값: 0xC0AAB101 |
|
IMAPI는 현재 미디어에 제공된 다중세션 유형을 지원하지 않습니다.
값: 0xC0AAB15C 참고IFileSystemImage::ImportFileSystem 메서드는 기록 장치에 미디어가 없는 경우 이 오류를 반환합니다.
|
|
매체에서 가져온 이전 세션의 호환되지 않는 레이아웃으로 인해 작업이 실패했습니다.
값: 0xC0AAB133 |
설명
IFileSystemImage::ImportFileSystem을 호출하기 전에 IFileSystemImage::put_MultisessionInterfaces를 호출해야 합니다. 또한 미디어가 비어 있지 않은지 확인하려면 IFileSystemImage::p ut_MultisessionInterfaces 전에 IDiscFormat2::get_MediaHeuristicallyBlank 호출하는 것이 좋습니다.
디스크에 둘 이상의 파일 시스템이 포함된 경우 하나의 파일 시스템만 가져옵니다. 이 메서드는 가져올 파일 시스템을 UDF, Joliet, ISO 9660 순서로 선택합니다. 가져오기에는 디렉터리 및 파일을 메모리 내 파일 시스템 구조로 전송하는 것이 포함됩니다.
메모리 내 파일 시스템을 생성하는 동안 언제든지 이 메서드를 호출할 수 있습니다. 가져오는 동안 메모리 내 복사본에 파일 또는 디렉터리가 이미 있으면 메모리 내 버전이 유지됩니다. 가져온 파일은 삭제됩니다.
디스크의 기본 파일 시스템인 파일 시스템을 확인하려면 IFileSystemImage::GetDefaultFileSystemForImport 메서드를 호출합니다.
이 메서드는 파일 정보만 읽습니다. 항목이 파일인 경우 IFsiDirectoryItem::AddFile, IFsiDirectoryItem::AddTree 또는 IFsiDirectoryItem::Add 메서드를 호출할 때 파일 데이터가 복사됩니다.
이 메서드는 마지막 세션에서 지원되는 파일 시스템을 찾을 수 없는 경우 IMAPI_E_NO_SUPPORTED_FILE_SYSTEM 반환합니다. 또한 이 메서드는 마지막 세션의 파일 시스템 레이아웃이 결과 이미지에 대해 요청된 파일 시스템을 만들기 위해 IMAPI에서 사용하는 레이아웃과 호환 되지 않는 경우 IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION 반환합니다. 자세한 내용은 IFileSystemImage::p ut_FileSystemsToCreate 메서드 설명서를 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | imapi2fs.h |