IFsiDirectoryItem2::AddTreeWithNamedStreams 메서드(imapi2fs.h)
모든 파일과 연결된 명명된 스트림과 함께 디렉터리 트리의 내용을 파일 시스템 이미지에 추가합니다.
구문
HRESULT AddTreeWithNamedStreams(
[in] BSTR sourceDirectory,
[in] VARIANT_BOOL includeBaseDirectory
);
매개 변수
[in] sourceDirectory
만들 디렉터리 트리의 상대 경로를 포함하는 문자열입니다. 경로는 파일 시스템 명명 규칙에 따라 유효한 문자만 포함해야 합니다. 이 매개 변수는 NULL일 수 없습니다.
[in] includeBaseDirectory
sourceDirectory의 디렉터리를 파일 시스템 이미지의 하위 디렉터리로 포함하려면 VARIANT_TRUE 로 설정합니다. 그렇지 않으면 VARIANT_FALSE.
반환 값
S_OK 성공에 따라 반환되지만 구현의 결과로 다른 성공 코드가 반환될 수 있습니다. 다음 오류 코드는 일반적으로 작업 실패 시 반환되지만 가능한 오류 값만 나타내지 않습니다.
| 반환 코드/값 | 설명 |
|---|---|
|
기능은 현재 파일 시스템 수정 버전에 대해 지원되지 않으므로 이 기능 없이 생성됩니다. |
|
매개 변수 '%1!ls!'에 지정된 값입니다. 잘못되었습니다. |
|
ls!' 가 파일 시스템의 일부가 아닙니다. 이 작업을 완료하려면 추가해야 합니다. |
|
'%1!ls!'에 대한 데이터 스트림을 만드는 동안 오류가 발생했습니다. |
|
'%1!ls!' 파일에 제공된 스트림에서 데이터를 읽을 수 없습니다. |
|
참조된 IFileSystemImage 개체가 읽기 전용 모드입니다. |
|
'%1!ls!' 이름이 이미 있습니다. |
|
'%1!ls!'을(를) 추가하면 결과 이미지의 크기가 현재 구성된 제한보다 커지게 됩니다. |
|
'%1!ls!' 파일에 제공된 데이터 스트림이 일치하지 않습니다. %2! I64d! 바이트, %3을(를) 찾았습니다. I64d! |
|
필요한 메모리를 할당하지 못했습니다. |
설명
새 하위 디렉터리에 대한 부모 디렉터리가 파일 시스템 이미지 내에 이미 있어야 합니다.
지정된 sourceDirectory 내의 하위 디렉터리 구조는 파일 시스템 이미지에 암시적으로 미러링됩니다. 파일 또는 디렉터리 충돌이 발생하면 지정된 원본 디렉터리의 콘텐츠가 우선합니다.
파일 시스템 이미지는 원본 디렉터리의 적절한 디렉터리 및 파일로 덮어씁니다. 처리하는 동안 예외가 발생하면 파일 시스템 이미지가 이전 상태로 되돌아갑니다.
결과 이미지에서 만들 수 있도록 설정된 파일 시스템 목록에 UDF가 포함되지 않은 파일 시스템 개체에 대해 이 메서드가 호출되거나 UDF 수정 버전이 2.00 미만인 경우 이 메서드는 IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED 성공 코드를 반환합니다. 이는 명명된 스트림이 추가되었지만 파일 시스템 개체에서 UDF 수정 버전 2.00 이상을 사용하도록 설정하지 않으면 결과 파일 시스템 이미지에 표시되지 않음을 나타냅니다.
ADS(대체 데이터 스트림)를 활용하는 경우 파일 시스템 이미지에는 1,000개의 스트림이 제한됩니다. 이 숫자를 초과하면 데이터가 손실됩니다.
이 방법은 Windows Server 2003 SP1(서비스 팩 1), WINDOWS XP sp2(서비스 팩 2) 및 Windows Vista에서 지원됩니다. 이 업데이트 패키지에서 제공하는 모든 기능은 기본적으로 Windows 7 및 Windows Server 2008 R2에서 지원됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | imapi2fs.h |