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::ImportSpecificFileSystem을 호출하기 전에 IFileSystemImage::put_MultisessionInterfaces를 호출해야 합니다. 또한 미디어가 비어 있지 않은지 확인하려면 IFileSystemImage::p ut_MultisessionInterfaces 전에 IDiscFormat2::get_MediaHeuristicallyBlank 호출하는 것이 좋습니다.

메모리 내 파일 시스템을 생성하는 동안 언제든지 이 메서드를 호출할 수 있습니다. 가져오는 동안 메모리 내 복사본에 파일 또는 디렉터리가 이미 있으면 메모리 내 버전이 유지됩니다. 가져온 파일이 삭제됩니다.

다시 쓰기 가능한 미디어(DVD+/-RW, DVDRAM, BD-RE)에서 파일 시스템 제한으로 인해 첫 번째 세션에 ISO9660 파일 시스템이 있는 경우 두 번째 세션을 가져오거나 굽기는 지원되지 않습니다.

이 메서드는 파일 정보만 읽습니다. 항목이 파일인 경우 IFsiDirectoryItem::AddFile, IFsiDirectoryItem::AddTree 또는 IFsiDirectoryItem::Add 메서드를 호출할 때 파일 데이터가 복사됩니다.

이 메서드는 마지막 세션의 파일 시스템 레이아웃이 결과 이미지에 대해 요청된 파일 시스템을 만드는 데 IMAPI에서 사용하는 레이아웃과 호환 되지 않는 경우 IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION 반환합니다. 자세한 내용은 IFileSystemImage::p ut_FileSystemsToCreate 메서드 설명서를 참조하세요. fileSystemToUse로 지정된 파일 시스템을 찾을 수 없는 경우 이 메서드는 IMAPI_E_FILE_SYSTEM_NOT_FOUND 반환합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 imapi2fs.h

참고 항목

IFileSystemImage