MSFT_Disk 클래스의 CreatePartition 메서드

디스크에 파티션을 만듭니다.

구문

UInt32 CreatePartition(
  [in]  UInt64  Size,
  [in]  Boolean UseMaximumSize,
  [in]  UInt64  Offset,
  [in]  UInt32  Alignment,
  [in]  Char16  DriveLetter,
  [in]  Boolean AssignDriveLetter,
  [in]  UInt16  MbrType,
  [in]  String  GptType,
  [in]  Boolean IsHidden,
  [in]  Boolean IsActive,
  [out] String  CreatedPartition,
  [out] String  ExtendedStatus
);

매개 변수

크기 [in]

파티션에 대해 원하는 크기(바이트)입니다. 디스크의 LargestFreeExtent 속성에서 지정한 크기와 같거나 작아야 합니다. 이 매개 변수는 UseMaximumSize와 함께 사용할 수 없습니다.

UseMaximumSize [in]

TRUE이면 파티션이 디스크에서 가장 큰 사용 가능한 범위를 채웁니다. 이 매개 변수는 Size 매개 변수와 함께 사용할 수 없습니다.

Offset [in]

파티션 오프셋(바이트)입니다. 오프셋이 정렬되지 않고 Alignment 매개 변수를 지정하지 않으면 파티션이 만들어진 디스크의 크기에 따라 오프셋이 가장 가까운 맞춤 경계로 반올림되거나 아래로 반올림됩니다.

맞춤 [in]

파티션의 맞춤(바이트)입니다.

DriveLetter [in]

생성 시 파티션에 할당할 드라이브 문자입니다. 이 매개 변수는 AssignDriveLetter와 함께 사용할 수 없습니다. 두 매개 변수를 모두 지정하면 잘못된 매개 변수 오류가 반환됩니다. 드라이브 문자를 사용할 수 없는 경우 파티션이 생성되지만 오류 '42002'가 반환됩니다.

AssignDriveLetter [in]

TRUE이면 사용 가능한 다음 드라이브 문자가 생성된 파티션에 할당됩니다. 더 이상 드라이브 문자를 사용할 수 없는 경우 파티션은 드라이브 문자 없이 만들어집니다. 이 매개 변수는 DriveLetter와 함께 사용할 수 없습니다. 두 매개 변수를 모두 지정하면 잘못된 매개 변수 오류가 반환됩니다.

MbrType [in]

MBR 파티션 형식을 지정합니다. 이 매개 변수는 디스크의 PartitionStyle 속성이 MBR인 경우에만 설정할 수 있으며, 그렇지 않으면 오류가 반환됩니다. 이 매개 변수의 기본값은 Huge입니다.

값	의미
FAT12 1	FAT12 파일 시스템 파티션입니다.
FAT16 4	FAT16 파일 시스템 파티션입니다.
확장 5	확장 파티션입니다.
거대한 6	거대한 파티션. 이 값은 파티션에 Windows 파일 시스템이 없음을 나타냅니다. 논리 볼륨을 만들 때 이 값을 사용합니다.
IFS 7	NTFS 또는 ExFAT 파티션입니다.
FAT32 12	FAT32 파티션입니다.

GptType [in]

파티션의 GPT 형식입니다. 이 매개 변수는 디스크의 PartitionStyle 속성이 GPT인 경우에만 유효합니다. 그렇지 않으면 오류가 반환됩니다. 이 매개 변수의 기본값은 기본 데이터입니다.

값	의미
시스템 파티션 c12a7328-f81f-11d2-ba4b-00a0c93ec93b	EFI 시스템 파티션입니다.
Microsoft Reserved e3c9e316-0b5c-4db8-817d-f92df00215ae	Microsoft 예약 파티션.
기본 데이터 ebd0a0a2-b9e5-4433-87c0-68b6b72699c7	기본 데이터 파티션입니다. Windows에서 만들고 인식하는 데이터 파티션 형식입니다. 이 유형의 파티션만 드라이브 문자를 할당하고, 볼륨 GUID 경로를 수신하고, 탑재된 폴더(볼륨 탑재 지점이라고도 함)를 호스트하고 FindFirstVolume 및 FindNextVolume 호출을 통해 열거할 수 있습니다.
LDM 메타데이터 5808c8aa-7e8f-42e0-85d2-e1e90434cfb3	동적 디스크의 LDM(논리 디스크 관리자) 메타데이터 파티션입니다.
LDM 데이터 af9b60a0-1431-4f62-bc68-3311714a69ad	파티션은 동적 디스크의 LDM 데이터 파티션입니다.
Microsoft Recovery de94bba4-06d1-4d40-a16a-bfd50179d6ac	Microsoft 복구 파티션.

IsHidden [in]

TRUE인 경우 파티션은 드라이브 문자 할당을 받을 수 없으며 탑재 관리자가 볼륨 GUID 이름을 할당하지도 않습니다. 파티션은 FindFirstVolume 및 FindNextVolume 함수에 의해 열거되지 않습니다. 파티션은 연결된 볼륨 디바이스 이름(예: "\\? GLOBALROOT\Device\HarddiskVolumeX").

IsActive [in]

TRUE이면 파티션의 MBR 활성 비트가 설정되고 파티션을 부팅할 수 있게 됩니다. 이 매개 변수는 MBR 디스크에만 유효합니다.

CreatedPartition [out]

생성된 파티션을 나타내는 포함된 MSFT_Partition 개체가 들어 있는 문자열입니다.

ExtendedStatus [out]

포함된 MSFT_StorageExtendedStatus 개체를 포함하는 문자열입니다.

이 매개 변수를 사용하면 스토리지 공급자가 확장(구현별) 오류 정보를 반환할 수 있습니다.

반환 값

성공 (0)

지원되지 않음 (1)

지정되지 않은 오류 (2)

시간 제한 (3)

실패( 4)

잘못된 매개 변수 (5)

디스크 사용 중 (6)

크기가 지원되지 않음 (4097)

사용 가능한 공간이 충분하지 않음 (40000)

액세스 거부됨 (40001)

작업을 완료하는 데 충분한 리소스가 없습니다. (40002)

캐시 만료( 40003)

Size 또는 UseMaximumSize 매개 변수를 사용하여 크기를 지정해야 합니다. 이러한 매개 변수 중 하나만 한 번에 지정할 수 있습니다. (40005)

디스크가 초기화되지 않았습니다. (41000)

디스크는 읽기 전용입니다. (41002)

디스크가 오프라인 상태입니다. (41003)

디스크의 파티션 제한에 도달했습니다. (41004)

지정된 파티션 맞춤이 잘못되었습니다. 디스크 섹터 크기의 배수여야 합니다. (41005)

매개 변수가 이 파티션 유형에 대해 유효하지 않습니다. (41006)

지정된 파티션 형식이 잘못되었습니다. (41010)

처음 2TB만 MBR 디스크에서 사용할 수 있습니다. (41011)

지정된 오프셋이 잘못되었습니다. (41012)

디바이스에 미디어가 없습니다. (41015)

지정된 오프셋이 잘못되었습니다. (41016)

지정된 파티션 레이아웃이 잘못되었습니다. (41017)

지정한 개체는 Microsoft 장애 조치(failover) 클러스터링 구성 요소에서 관리됩니다. 디스크는 클러스터 유지 관리 모드여야 하며 이 작업을 수행하려면 클러스터 리소스 상태 온라인 상태여야 합니다. (41018)

요청된 액세스 경로가 이미 사용 중입니다. (42002)

숨겨진 파티션에 액세스 경로를 할당할 수 없습니다. (42004)

액세스 경로가 잘못되었습니다. (42007)

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
네임스페이스	Root\Microsoft\Windows\Storage
MOF	Storagewmi.mof

추가 정보

MSFT_Disk