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

파일 시스템 이미지에서 지정된 디렉터리 트리를 제거합니다.

구문

HRESULT RemoveTree(
  [in] BSTR path
);

매개 변수

[in] path

제거할 디렉터리의 이름을 포함하는 문자열입니다. 경로는 현재 디렉터리 항목을 기준으로 합니다.

반환 값

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

반환 코드 설명
E_POINTER
path 매개 변수가 유효한 포인터가 아닙니다.
IMAPI_E_INVALID_PARAM
%1!ls! 매개 변수에 지정된 값이 잘못되었습니다.

값: 0xC0AAB101

IMAPI_E_INVALID_PATH
경로 '%1!s!' 형식이 잘못되었거나 잘못된 문자가 포함되어 있습니다.

값: 0xC0AAB110

IMAPI_E_NOT_IN_FILE_SYSTEM
ls!' 가 파일 시스템의 일부가 아닙니다. 이 작업을 완료하려면 추가해야 합니다.

값: 0xC0AAB10B

IMAPI_E_READONLY
FileSystemImage 개체가 읽기 전용 모드입니다.

값: 0xC0AAB102

IMAPI_E_DIR_NOT_FOUND
지정한 디렉터리가 없습니다.
IMAPI_E_DIR_NOT_EMPTY
%1!s! 디렉터리가 비어 있지 않습니다.

값: 0xC0AAB10A

IMAPI_E_FSI_INTERNAL_ERROR
내부 오류가 발생했습니다. %1!ls!.

값: 0xC0AAB100

IMAPI_E_NOT_DIR
지정된 경로 %1!ls!이( 가) 디렉터리를 식별하지 않습니다.

값: 0xC0AAB109

설명

디렉터리 항목은 파일 시스템 이미지에 있어야 합니다.

루트 디렉터리 항목에 대해 이 메서드를 호출하고 경로를 단일 경로 구분 기호(\)로 설정하여 전체 파일 시스템 이미지를 삭제할 수 있습니다.

요구 사항

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

참고 항목

IFsiDirectoryItem

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::AddTree

IFsiDirectoryItem::Remove