CREATE_PARTITION_PARAMETERS 구조체(vds.h)

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

파티션 스타일의 파티션 매개 변수를 정의합니다.

구문

typedef struct _CREATE_PARTITION_PARAMETERS {
  VDS_PARTITION_STYLE style;
  union {
    struct {
      BYTE    partitionType;
      BOOLEAN bootIndicator;
    } MbrPartInfo;
    struct {
      GUID      partitionType;
      GUID      partitionId;
      ULONGLONG attributes;
      WCHAR     name[36];
    } GptPartInfo;
  };
} CREATE_PARTITION_PARAMETERS;

멤버

style

MbrPartInfo

MBR(마스터 부팅 레코드) 디스크에 대한 매개 변수입니다. 스타일VDS_PST_MBR 경우에 사용됩니다.

MbrPartInfo.partitionType

시스템 정의 MBR 파티션 형식을 나타냅니다. 가능한 값은 다음과 같습니다.

의미
PARTITION_ENTRY_UNUSED
0x00
사용하지 않는 항목입니다.
PARTITION_FAT_12
0x01
12비트 FAT 항목이 있는 파티션을 지정합니다.
PARTITION_XENIX_1
0x02
XENIX 형식 1 파티션을 지정합니다.
PARTITION_XENIX_2
0x03
XENIX 형식 2 파티션을 지정합니다.
PARTITION_FAT_16
0x04
16비트 FAT 항목이 있는 파티션을 지정합니다.
PARTITION_EXTENDED
0x05
MS-DOS V4 확장 파티션을 지정합니다.
PARTITION_HUGE
0x06
MS-DOS V4 거대한 파티션을 지정합니다. 이 값은 파티션에 Microsoft 파일 시스템이 없음을 나타냅니다. 논리 볼륨을 만들 때 이 값을 사용합니다.
PARTITION_IFS
0x07
NTFS 또는 ExFAT 파티션을 지정합니다.
PARTITION_OS2BOOTMGR
0x0A
OS/2 부팅 관리자, OPUS 또는 일관된 스왑 파티션을 지정합니다.
PARTITION_FAT32
0x0B
FAT32 파티션을 지정합니다.
PARTITION_FAT32_XINT13
0x0C
이 값은 지원되지 않습니다.
PARTITION_XINT13
0x0E
이 값은 지원되지 않습니다.
PARTITION_XINT13_EXTENDED
0x0F
이 값은 지원되지 않습니다.
PARTITION_PREP
0x41
PowerPC 참조 플랫폼 파티션을 지정합니다.
PARTITION_LDM
0x42
논리 디스크 관리자 파티션을 지정합니다.
PARTITION_UNIX
0x63
UNIX 파티션을 지정합니다.
PARTITION_NTFT
0x80
NTFT 파티션을 지정합니다. 이 값은 이 테이블의 다른 값과 조합(즉, 논리적으로 비트 ORed)에 사용됩니다.

MbrPartInfo.bootIndicator

TRUE이면 파티션이 활성 상태이며 부팅할 수 있습니다. 그렇지 않으면 파티션을 사용하여 시스템을 부팅할 수 없습니다.

GptPartInfo

GPT(GUID 파티션 테이블) 디스크에 대한 매개 변수입니다. 스타일VDS_PST_GPT 경우에 사용됩니다.

GptPartInfo.partitionType

파티션 형식의 GUID입니다.

의미
PARTITION_ENTRY_UNUSED_GUID
00000000-0000-0000-0000-000000000000
파티션이 없습니다.

이 특성은 기본 및 동적 디스크에 대해 설정할 수 있습니다.

PARTITION_SYSTEM_GUID
c12a7328-f81f-11d2-ba4b-00a0c93ec93b
파티션은 EFI 시스템 파티션입니다.

이 특성은 기본 및 동적 디스크에 대해 설정할 수 있습니다.

PARTITION_MSFT_RESERVED_GUID
e3c9e316-0b5c-4db8-817d-f92df00215ae
파티션은 Microsoft 예약 파티션입니다.

이 특성은 기본 및 동적 디스크에 대해 설정할 수 있습니다.

PARTITION_BASIC_DATA_GUID
ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
Windows에서 만들고 인식하는 데이터 파티션 형식입니다.

이 유형의 파티션만 드라이브 문자를 할당하고, 볼륨 GUID 경로를 수신하고, 탑재된 폴더(볼륨 탑재 지점이라고도 함)를 호스트하고 FindFirstVolumeFindNextVolume 호출을 통해 열거할 수 있습니다.

이 값은 한 가지 예외를 제외하고 기본 디스크에 대해서만 설정할 수 있습니다. 이후 동적 디스크로 변환되는 기본 디스크의 파티션에 대해 PARTITION_BASIC_DATA_GUID 및 GPT_ATTRIBUTE_PLATFORM_REQUIRED 모두 설정된 경우 나머지 디스크가 동적 디스크임에도 불구하고 파티션은 기본 파티션으로 유지됩니다. 파티션이 GPT 디스크의 OEM 파티션으로 간주되기 때문입니다.

PARTITION_LDM_METADATA_GUID
5808c8aa-7e8f-42e0-85d2-e1e90434cfb3
파티션은 동적 디스크의 LDM(논리 디스크 관리자) 메타데이터 파티션입니다.

이 값은 동적 디스크에 대해서만 설정할 수 있습니다.

PARTITION_LDM_DATA_GUID
af9b60a0-1431-4f62-bc68-3311714a69ad
파티션은 동적 디스크의 LDM 데이터 파티션입니다.

이 값은 동적 디스크에 대해서만 설정할 수 있습니다.

PARTITION_MSFT_RECOVERY_GUID
de94bba4-06d1-4d40-a16a-bfd50179d6ac
파티션은 Microsoft 복구 파티션입니다.

이 특성은 기본 및 동적 디스크에 대해 설정할 수 있습니다.

GptPartInfo.partitionId

파티션의 ID인 경우 만들 때 GUID_NULL(0)로 설정하면 고유한 값이 생성됩니다.

GptPartInfo.attributes

파티션의 특성입니다. 다음 값 중 하나 이상일 수 있습니다.

의미
GPT_ATTRIBUTE_PLATFORM_REQUIRED
0x0000000000000001
이 특성이 설정된 경우 파티션이 제대로 작동하려면 컴퓨터에서 필요합니다.

예를 들어 OEM 파티션에 대해 이 특성을 설정해야 합니다. 이 특성이 설정된 경우 DiskPart.exe 유틸리티를 사용하여 파티션 삭제와 같은 파티션 작업을 수행할 수 있습니다. 그러나 파티션은 볼륨이 아니므로 DiskPart.exe 유틸리티를 사용하여 파티션에서 볼륨 작업을 수행할 수 없습니다.

이 특성은 기본 및 동적 디스크에 대해 설정할 수 있습니다. 기본 디스크의 파티션에 대해 설정되고 디스크가 동적 디스크로 변환되는 경우 나머지 디스크가 동적 디스크임에도 불구하고 파티션은 기본 파티션으로 유지됩니다. 파티션이 GPT 디스크의 OEM 파티션으로 간주되기 때문입니다.

GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER
0x8000000000000000
이 특성을 설정하면 디스크를 다른 컴퓨터로 이동하거나 컴퓨터에서 디스크를 처음으로 볼 때 파티션은 기본적으로 드라이브 문자를 받지 않습니다.

이 특성은 SAN(저장 영역 네트워크) 환경에서 유용합니다.

이름에도 불구하고 이 특성은 기본 및 동적 디스크에 대해 설정할 수 있습니다.

GPT_BASIC_DATA_ATTRIBUTE_HIDDEN
0x4000000000000000
이 특성을 설정하면 탑재 관리자에서 파티션을 검색하지 않습니다.

결과적으로 파티션은 드라이브 문자를 받지 않고, 볼륨 GUID 경로를 받지 않으며, 탑재된 폴더(볼륨 탑재 지점이라고도 함)를 호스트하지 않으며 , FindFirstVolumeFindNextVolume 호출로 열거되지 않습니다. 이렇게 하면 디스크 조각 모음과 같은 애플리케이션이 파티션에 액세스하지 않습니다. VSS(볼륨 섀도 복사본 서비스)는 이 특성을 사용합니다.

이름에도 불구하고 이 특성은 기본 및 동적 디스크에 대해 설정할 수 있습니다.

GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY
0x2000000000000000
이 특성을 설정하면 파티션은 다른 파티션의 섀도 복사본입니다.

이 특성은 VSS(볼륨 섀도 복사본 서비스)에서 사용됩니다. 이 특성은 볼륨에 연결하지 않도록 파일 시스템 필터 드라이버 기반 소프트웨어(예: 바이러스 백신 프로그램)에 대한 표시입니다.

애플리케이션은 특성을 사용하여 섀도 복사본 볼륨을 프로덕션 볼륨과 구분할 수 있습니다. 예를 들어 빠른 복구를 수행하는 애플리케이션은 읽기 전용 및 숨겨진 특성과 이 특성을 지워 섀도 복사본 LUN을 중단합니다. 이 특성은 섀도 복사본이 만들어지고 섀도 복사본이 끊어질 때 지워질 때 설정됩니다.

이름에도 불구하고 이 특성은 기본 및 동적 디스크에 대해 설정할 수 있습니다.

Windows Server 2003: 이 특성은 WINDOWS Server 2003 SP1 이전에는 지원되지 않습니다.

GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY
0x1000000000000000
이 특성이 설정되면 파티션은 읽기 전용입니다.

파티션에 쓰는 모든 요청이 실패합니다.
파일 시스템이 있는 경우 파일 시스템이 읽기 전용으로 탑재되는 ERROR_WRITE_PROTECT Win32 오류 코드로 인해 IOCTL_DISK_IS_WRITABLE 실패합니다.

VSS는 이 특성을 사용합니다.

동적 디스크에 대해 이 특성을 설정하지 마세요. 설정하면 I/O 오류가 발생하고 파일 시스템이 제대로 탑재되지 않도록 방지할 수 있습니다.

GptPartInfo.name[36]

파티션의 이름을 지정하는 Null로 끝나는 유니코드 문자열입니다.

설명

IVdsAdvancedDisk::CreatePartition 메서드는 이 구조를 인수로 전달하여 매개 변수 집합을 지정합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 vds.h

추가 정보

IVdsAdvancedDisk::CreatePartition

VDS 구조체

VDS_PARTITION_STYLE