MSFT_Disk 클래스의 Clear 메서드
파티션 정보를 제거하고 디스크를 초기화하지 않고 RAW 상태로 반환합니다.
구문
UInt32 Clear(
[in] Boolean RemoveData,
[in] Boolean RemoveOEM,
[in] Boolean ZeroOutEntireDisk,
[out] String ExtendedStatus
);
매개 변수
RemoveData [in]
TRUE 이면 디스크에서 데이터 파티션을 제거할 수 있습니다. 이 매개 변수가 FALSE 또는 NULL이면 데이터 파티션이 있으면 이 메서드가 실패합니다.
RemoveOEM [in]
OEM 및 기타 특수 파티션을 제거해도 된다면 TRUE입니다. 이 매개 변수가 FALSE 이거나 지정되지 않은 경우 이러한 유형의 파티션이 있으면 이 메서드가 실패합니다.
ZeroOutEntireDisk [in]
TRUE 이면 이 매개 변수가 모든 파티션 정보를 제거하는 것 외에도 전체 디스크를 0으로 제거하도록 이 메서드에 지시합니다. 이 매개 변수가 FALSE 또는 NULL인 경우 디스크의 첫 번째 및 마지막 메가바이트만 0이 됩니다.
ExtendedStatus [out]
포함된 MSFT_StorageExtendedStatus 개체를 포함하는 문자열입니다.
이 매개 변수를 사용하면 스토리지 공급자가 확장(구현별) 오류 정보를 반환할 수 있습니다.
반환 값
성공 (0)
지원되지 않음 (1)
지정되지 않은 오류 (2)
시간 제한 (3)
실패( 4)
잘못된 매개 변수 (5)
디스크 사용 중 (6)
액세스 거부됨 (40001)
작업을 완료하는 데 충분한 리소스가 없습니다. (40002)
캐시 만료( 40003)
디스크가 초기화되지 않았습니다. (41000)
디스크는 읽기 전용입니다. (41002)
디스크가 오프라인 상태입니다. (41003)
OEM 파티션이 있으면 지울 수 없습니다. OEM 파티션을 지우려면 RemoveOEM 플래그를 사용합니다. (41007)
데이터 파티션이 있으면 지울 수 없습니다. 데이터 파티션을 지우려면 RemoveData 플래그를 사용합니다. (41008)
중요한 디스크에서 작업이 지원되지 않습니다. (41009)
디바이스에 미디어가 없습니다. (41015)
지정된 개체는 Microsoft 장애 조치(failover) 클러스터링 구성 요소에서 관리됩니다. 이 작업을 수행하려면 클러스터에서 디스크를 제거해야 합니다. (41019)
설명
호출자는 디스크에서 모든 데이터 파티션, 알려진 OEM 파티션 및 ESP 파티션을 먼저 삭제하지 않는 한 RemoveData, RemoveOEM 또는 둘 다를 지정해야 합니다. 이 요구 사항은 MSR, LDM 메타데이터 파티션 및 알 수 없는 OEM 파티션과 같은 메타데이터 파티션을 제외합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 네임스페이스 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |