IVdsAdvancedDisk::Clean 메서드(vds.h)

  • 아티클

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

파티션 정보를 제거하고 기본 또는 동적 디스크를 초기화하지 않습니다.

Windows Server 2003: Clean 메서드는 이동식 디바이스에서 지원되지 않습니다.

구문

HRESULT Clean(
  [in]  BOOL      bForce,
  [in]  BOOL      bForceOEM,
  [in]  BOOL      bFullClean,
  [out] IVdsAsync **ppAsync
);

매개 변수

[in] bForce

TRUE이면 데이터 볼륨 또는 ESP 파티션이 포함된 디스크를 정리합니다.

[in] bForceOEM

TRUE이면 다음 표에 알려진 OEM 파티션이 포함된 MBR 기반 디스크를 정리하거나 OEM 파티션이 포함된 GPT 기반 디스크를 정리합니다. OEM 파티션에는 GPT 기반 디스크에 설정된 GPT_ATTRIBUTE_PLATFORM_REQUIRED 플래그가 있습니다.

파티션 유형 Description
0x12 EISA 파티션입니다.
0x84 랩톱의 최대 절전 모드 파티션입니다.
0xA0 일부 HP 노트북에 대한 진단 파티션입니다.
0xDE Dell에서 정의한 파티션입니다.
0xFE IBM IML 파티션.

[in] bFullClean

TRUE이면 각 섹터의 데이터를 0으로 바꿔 전체 디스크를 정리합니다. 그렇지 않으면 이 메서드는 디스크의 첫 번째 및 마지막 메가바이트만 정리합니다.

[out] ppAsync

반환 시 VDS가 초기화하는 IVdsAsync 인터페이스 포인터에 대한 포인터의 주소입니다. 호출자는 인터페이스를 해제해야 합니다. 이 포인터를 사용하여 작업 상태를 취소, 대기 또는 쿼리할 수 있습니다.

반환 값

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

반환 코드/값 Description
S_OK
 데이터가 성공적으로 제거되었고 디스크가 초기화되지 않았습니다.
VDS_E_NO_MEDIA
0x80042412L
 이동식 디바이스에는 미디어가 없습니다.
VDS_E_MISSING_DISK
0x80042454L
 디스크가 없습니다.
VDS_E_OPERATION_DENIED
0x8004240AL
 다음 조건 중 하나에서 작업이 실패했습니다.
  • 디스크에 OEM 파티션이 포함되고 bForceOEM 이 false입니다.
  • 디스크에 볼륨 또는 ESP 파티션이 포함되고 bForce 가 FALSE입니다.
  • 디스크에는 bForce 가 TRUE 인지 FALSE인지 여부에 관계없이 시스템 볼륨 중 하나가 포함됩니다. 시스템 볼륨은 다음 항목 중 어느 것일 수 있습니다.
    • 운영 체제 로더를 포함하는 볼륨입니다.
    • system32 디렉터리를 포함하는 부팅 볼륨입니다.
    • 페이지 파일 또는 최대 절전 모드 파일을 포함하는 볼륨 또는 크래시 덤프로 사용되는 볼륨입니다.
    • ESP 파티션(시스템이 부팅되는 파티션)입니다.
VDS_S_DISK_PARTIALLY_CLEANED
0x0004241AL
 파티션 테이블은 정리되지만 모든 섹터가 완전히 정리되는 동안 정리되지는 않습니다. 또는 첫 번째 메가바이트와 마지막 메가바이트의 일부 섹터가 정리됩니다. 그러나 청소가 완전히 깨끗하지 않으면 나머지 섹터는 청소되지 않습니다.

설명

이 메서드를 호출하기 전에 호출자는 각 볼륨에 대해 IVdsVolumeMF::D mount 를 호출하여 디스크에 탑재된 볼륨을 분리해야 합니다.

디스크에서 모든 데이터 볼륨, 알려진 OEM 파티션 및 ESP 파티션을 먼저 삭제하지 않는 한 bForce 매개 변수, bForceOEM 매개 변수 또는 둘 다 이 메서드와 함께 사용합니다. 이 요구 사항은 MSR, LDM 메타데이터 파티션 및 알 수 없는 OEM 파티션과 같은 메타데이터 파티션을 제외합니다.

Windows Server 2003: Clean 메서드는 이동식 디바이스에서 지원되지 않습니다.

구현자는 호출이 비동기 작업을 시작하는지 여부에 관계없이 이 메서드에 대한 IVdsAsync 인터페이스에 대한 포인터를 반환해야 합니다.

요구 사항

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

추가 정보

Disk 개체

IVdsAdvancedDisk

IVdsAsync