IVdsService::CleanupObsoleteMountPoints 메서드(vds.h)

[Windows 8 및 Windows Server 2012 가상 디스크 서비스 COM 인터페이스는 Windows Storage 관리 API로 대체됩니다.]

더 이상 존재하지 않는 볼륨에 대한 사용자 모드 경로 및 탑재된 폴더를 제거합니다.

구문

HRESULT CleanupObsoleteMountPoints();

반환 값

이 메서드는 표준 HRESULT 값( 예: E_INVALIDARG 또는 E_OUTOFMEMORY) 및 VDS 관련 반환 값을 반환할 수 있습니다. 또한 HRESULT_FROM_WIN32 매크로를 사용하여 변환된 시스템 오류 코드를 반환할 수도 있습니다. 오류는 VDS 자체 또는 사용 중인 기본 VDS 공급자 에서 발생할 수 있습니다. 가능한 반환 값은 다음과 같습니다.

반환 코드/값	Description
S_OK	오래된 사용자 모드 경로 및 탑재된 폴더가 성공적으로 제거되었습니다.
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS를 초기화하지 못했습니다. 서비스가 초기화를 완료하기 전에 애플리케이션이 이 메서드를 호출하면 초기화가 완료될 때까지 메서드가 차단됩니다. 초기화에 실패하면 이 오류가 반환됩니다.

설명

기본적으로 레지스트리는 제거된 볼륨에 대한 드라이브 문자 매핑 정보를 유지합니다. 볼륨이 포함된 디스크가 컴퓨터에서 제거되면 레지스트리 항목이 유지되므로 디스크와 볼륨이 동일한 컴퓨터로 반환되는 경우 볼륨은 동일한 드라이브 문자를 받습니다. 디스크가 새 컴퓨터로 이동되면 레지스트리 항목이 함께 이동하지 않으므로 볼륨이 다른 드라이브 문자와 볼륨 GUID를 받을 수 있습니다.

CleanupObsoleteMountPoints 메서드는 이러한 레지스트리 항목을 제거합니다. 제거되는 세 가지 유형의 레지스트리 항목이 있습니다.

• 볼륨에 드라이브 문자 또는 볼륨 GUID가 없는 경우 이 메서드에서 제거되는 "드라이브 문자 없음" 레지스트리 항목이 있습니다.
• 그렇지 않으면 볼륨에 볼륨 GUID 및 드라이브 문자에 대한 레지스트리 항목이 있습니다. 둘 다이 메서드에 의해 제거됩니다.

또한 볼륨에 탑재된 폴더가 포함된 경우 CleanupObsoleteMountPoints 는 해당 폴더를 제거합니다. 예를 들어 Disk1의 Volume1이 제거되고 Volume1이 Disk2에서 x:\MountVolume1로 탑재되는 경우 Disk2의 \MountVolume1 폴더도 삭제됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	vds.h
라이브러리	Uuid.lib

추가 정보

IVdsService