MSFT_Volume 클래스의 Format 메서드
볼륨의 형식을 지정합니다.
구문
UInt32 Format(
[in] String FileSystem,
[in] String FileSystemLabel,
[in] UInt32 AllocationUnitSize,
[in] Boolean Full,
[in] Boolean Force,
[in] Boolean Compress,
[in] Boolean ShortFileNameSupport,
[in] Boolean SetIntegrityStreams,
[in] Boolean UseLargeFRS,
[in] Boolean DisableHeatGathering,
[out] String FormattedVolume,
[out] String ExtendedStatus
);
매개 변수
FileSystem [in]
볼륨에 적용할 파일 시스템입니다. (다음 버전 중 하나)
- "ExFAT"
- "FAT"
- "FAT32"
- "NTFS"
- "ReFS"
FileSystemLabel [in]
볼륨의 파일 시스템 레이블입니다.
AllocationUnitSize [in]
할당 단위 크기(바이트)입니다.
전체 [in]
전체 형식의 경우 TRUE , 빠른 형식의 경우 FALSE 입니다.
강제 적용 [in]
형식 작업을 강제로 적용하려면 TRUE 이고, 그렇지 않으면 FALSE입니다.
압축 [in]
볼륨을 압축하려면 TRUE , 그렇지 않으면 FALSE입니다. FileSystem이 ReFS로 설정된 경우 정의되지 않은 상태로 둡니다.
ShortFileNameSupport [in]
볼륨에서 짧은 이름을 지원해야 하면 TRUE 이고, 그렇지 않으면 FALSE입니다. FileSystem이 ReFS로 설정된 경우 정의되지 않은 상태로 둡니다.
SetIntegrity스트림 [in]
무결성 스트림을 설정하려면 TRUE 입니다. FileSystem이 ReFS로 설정되지 않은 경우 정의되지 않은 상태로 둡니다.
UseLargeFRS [in]
큰 FRS를 사용하려면 TRUE , 그렇지 않으면 FALSE입니다. FileSystem이 ReFS로 설정된 경우 정의되지 않은 상태로 둡니다.
DisableHeatGathering [in]
열 수집을 사용하지 않으려면 TRUE , 그렇지 않으면 FALSE입니다.
FormattedVolume [out]
서식이 지정된 볼륨을 나타내는 MSFT_Volume 개체를 받습니다.
ExtendedStatus [out]
포함된 MSFT_StorageExtendedStatus 개체를 포함합니다.
이 매개 변수를 사용하면 스토리지 공급자가 확장된(구현별) 오류 정보를 반환할 수 있습니다.
반환 값
성공(0)
지원되지 않음(1)
지정되지 않은 오류(2)
시간 제한(3)
실패함(4)
잘못된 매개 변수(5)
이 명령은 x64 환경에서 실행되는 x86에서 지원되지 않습니다. (7)
액세스 거부됨 (40001)
예기치 않은 I/O 오류가 발생했습니다 (40004)
지정된 개체는 Microsoft 장애 조치(failover) 클러스터링 구성 요소에 의해 관리됩니다. 이 작업을 수행하려면 디스크가 클러스터 기본 테넌트 모드이고 클러스터 리소스 상태 온라인 상태여야 합니다. (40018)
시스템 또는 중요 파티션에서는 작업이 허용되지 않습니다. (42010)
지정한 클러스터 크기가 잘못 되었습니다(43000).
지정된 파일 시스템이 지원 되지 않음(43001)
볼륨을 빠르게 포맷 할 수 없습니다(43002)
클러스터 수가 32비트(43003)를 초과합니다 .
지정된 UDF 버전이 지원 되지 않음(43004)
클러스터 크기는 디스크의 실제 섹터 크기의 배수여야 합니다(43005).
드라이브가 읽기 전용 인 경우 요청된 작업을 수행할 수 없음(43006)
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 네임스페이스 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |