IFsiDirectoryItem::AddTree 메서드(imapi2fs.h)

디렉터리 트리의 내용을 파일 시스템 이미지에 추가합니다.

구문

HRESULT AddTree(
  [in] BSTR         sourceDirectory,
  [in] VARIANT_BOOL includeBaseDirectory
);

매개 변수

[in] sourceDirectory

만들 디렉터리 트리의 상대 경로를 포함하는 문자열입니다.

루트 디렉터리 항목에서 이 메서드를 호출할 때 전체 경로를 지정합니다.

[in] includeBaseDirectory

sourceDirectory의 디렉터리를 파일 시스템 이미지의 하위 디렉터리로 포함하려면 VARIANT_TRUE 로 설정합니다. 그렇지 않으면 VARIANT_FALSE.

반환 값

S_OK 성공하면 반환되지만 구현의 결과로 다른 성공 코드가 반환될 수 있습니다. 다음 오류 코드는 일반적으로 작업 실패 시 반환되지만 가능한 유일한 오류 값은 나타내지 않습니다.

반환 코드	설명
E_OUTOFMEMORY	필요한 메모리를 할당하지 못했습니다. 값: 0x8007000E
E_POINTER	포인터가 잘못되었습니다. 값: 0x80004003
IMAPI_E_DIRECTORY_READ_FAILURE	권한으로 인해 디렉터리 트리에서 파일을 열거하는 데 실패할 수 없습니다. 값: 0xC0AAB12BL
IMAPI_E_DATA_STREAM_CREATE_FAILURE	사용 권한으로 인해 디렉터리 트리에 있는 하나 이상의 파일에 액세스할 수 없습니다. 값: 0xC0AAB12A
IMAPI_E_DATA_STREAM_READ_FAILURE	파일 '%1!ls!'에 제공된 스트림에서 데이터를 읽을 수 없습니다. 값: 0xC0AAB129
IMAPI_E_INVALID_PARAM	%1!ls! 매개 변수에 지정된 값이 잘못되었습니다. 값: 0xC0AAB101
IMAPI_E_NOT_IN_FILE_SYSTEM	ls!' 가 파일 시스템의 일부가 아닙니다. 이 작업을 완료하려면 추가해야 합니다. 값: 0xC0AAB10B
IMAPI_E_READONLY	FileSystemImage 개체가 읽기 전용 모드입니다. 값: 0xC0AAB102
IMAPI_E_IMAGE_SIZE_LIMIT	이 파일 또는 디렉터리를 추가하면 결과 이미지의 크기가 현재 구성된 제한보다 큽니다. 값: 0xC0AAB120
IMAPI_E_INVALID_PATH	경로 '%1!s!' 형식이 잘못되었거나 잘못된 문자가 포함되어 있습니다. 값: 0xC0AAB110
IMAPI_E_DUP_NAME	ls!' 이름이 이미 있습니다. 값: 0xC0AAB112
IMAPI_E_NO_UNIQUE_NAME	'%1!ls!'을(를) 추가하려고 시도합니다. 실패: %2!ls!에 대한 파일 시스템별 고유 이름을 만들 수 없습니다. 파일 시스템으로 수행합니다. 값: 0xC0AAB113
IMAPI_E_ISO9660_LEVELS	ISO9660 8개 수준의 디렉터리로 제한됩니다. 값: 0xC0AAB131
IMAPI_E_TOO_MANY_DIRS	이 파일 시스템 이미지에는 %1!ls!에 대한 디렉터리를 너무 많이 가지고 있습니다. 파일 시스템으로 수행합니다. 값: 0xC0AAB130
IMAPI_E_DIR_NOT_FOUND	디렉터리 '%1!s!' FileSystemImage 계층 구조에서 찾을 수 없습니다. 값: 0xC0AAB11A

 

참고GetFileAttributesEx 및 FindFirstFile 함수에서 반환된 값도 여기에 반환될 수 있습니다.

 

설명

새 하위 디렉터리에 대한 부모 디렉터리가 파일 시스템 이미지 내에 이미 있어야 합니다.

지정된 원본 디렉터리 내의 하위 디렉터리 구조는 파일 시스템 이미지에서 암시적으로 미러링됩니다.

파일 또는 디렉터리 충돌이 발생하면 지정된 원본 디렉터리의 콘텐츠가 우선합니다. 파일 시스템 이미지는 원본 디렉터리의 적절한 디렉터리 및 파일로 덮어씁니다.

처리 중에 예외가 발생하면 파일 시스템 이미지가 이전 상태로 되돌아갑니다.

요구 사항

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

추가 정보

IFsiDirectoryItem

IFsiDirectoryItem::Add

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::Remove