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 |
|---|---|
|
데이터가 성공적으로 제거되었고 디스크가 초기화되지 않았습니다. |
|
이동식 디바이스에는 미디어가 없습니다. |
|
디스크가 없습니다. |
|
다음 조건 중 하나에서 작업이 실패했습니다.
|
|
파티션 테이블은 정리되지만 모든 섹터가 완전히 정리되는 동안 정리되지는 않습니다. 또는 첫 번째 메가바이트와 마지막 메가바이트의 일부 섹터가 정리됩니다. 그러나 청소가 완전히 깨끗하지 않으면 나머지 섹터는 청소되지 않습니다. |
설명
이 메서드를 호출하기 전에 호출자는 각 볼륨에 대해 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 |