스토리지 풀의 리소스를 사용하여 가상 디스크 및 단일 볼륨을 만듭니다.
구문
UInt32 CreateVolume(
[in] String FriendlyName,
[in] UInt64 Size,
[in] String StorageTiers[],
[in] UInt64 StorageTierSizes[],
[in] UInt16 ProvisioningType,
[in] String ResiliencySettingName,
[in] UInt16 PhysicalDiskRedundancy,
[in] UInt16 NumberOfColumns,
[in] UInt16 FileSystem,
[in] String AccessPath,
[in] String FileServer,
[out] String CreatedVolume,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
매개 변수
FriendlyName [in]
볼륨의 식별 이름입니다. 식별 이름은 볼륨을 설명해야 합니다. 고유할 필요는 없습니다. 파일 시스템의 레이블도 이 이름으로 설정됩니다.
이 매개 변수는 필수이며 NULL일 수 없습니다.
크기 [in]
가상 디스크의 크기입니다. 일부 스토리지 하위 시스템은 크기를 할당 단위 크기의 배수로 반올림합니다. 생성된 볼륨의 크기는 이 가상 디스크 크기에서 허용하는 크기만큼 커집니다.
StorageTiers [in]
가상 디스크의 스토리지 계층입니다. 각 배열 요소는 MSFT_StorageTier 개체입니다.
StorageTierSizes [in]
계층의 크기입니다.
ProvisioningType [in]
볼륨의 프로비저닝 유형입니다.
| 값 | 의미 |
|---|---|
| 1 | 씬 프로비저닝 - 볼륨에 대한 스토리지가 주문형으로 할당됩니다. |
| 2 | 프로비저닝이 수정됨 - 볼륨을 만들 때 볼륨에 대한 스토리지가 할당됩니다. |
ResiliencySettingName [in]
이 볼륨의 템플릿으로 사용할 복원력 설정의 이름입니다. 복원력 설정 instance Name 속성과 동일합니다. 이 스토리지 풀과 연결된 복원력 설정만 사용할 수 있습니다.
PhysicalDiskRedundancy [in]
가상 디스크가 데이터 손실 없이 견딜 수 있는 실제 디스크 오류 수입니다. 지정하지 않으면 사용된 값은 ResiliencySettingName에 지정된 복원력 설정의 PhysicalDiskRedundancyDefault 멤버입니다.
NumberOfColumns [in]
데이터를 스트라이프하는 데 사용할 실제 디스크 수입니다. 지정하지 않으면 사용된 값은 ResiliencySettingName에 지정된 복원력 설정의 NumberOfColumnsDefault 멤버입니다.
FileSystem [in]
생성된 볼륨에서 사용할 파일 시스템의 형식입니다. CSV 파일 시스템은 스토리지 공간 하위 시스템에서만 지원됩니다. CSV의 경우 풀은 클러스터 가능해야 하며 생성된 볼륨은 클러스터 공유 볼륨이 됩니다.
이 매개 변수는 필수이며 NULL일 수 없습니다.
| 값 | 의미 |
|---|---|
| 14 | NTFS |
| 15 | ReFS |
| 0x8000 | CSVFS_NTFS |
| 0x8001 | CSVFS_ReFS |
AccessPath [in]
볼륨에 대한 로컬 액세스 경로입니다. 액세스 경로를 설정할 수 없거나 이 매개 변수가 NULL인 경우 새 액세스 경로가 할당됩니다.
FileServer [in]
Windows 10 시작: 이 볼륨을 소유할 파일 서버를 나타내는 포함된 MSFT_FileServer 개체를 포함하는 문자열입니다.
CreatedVolume [out]
생성된 볼륨, MSFT_Volume 개체입니다.
CreatedStorageJob [out]
장기 실행 작업을 추적하는 데 사용되는 스토리지 작업 개체에 대한 참조를 반환합니다.
ExtendedStatus [out]
MSFT_StorageExtendedStatus 개체의 확장된 오류 정보입니다. 정보는 구현에 따라 다릅니다.
반환 값
성공 (0)
지원되지 않음 (1)
지정되지 않은 오류 (2)
시간 제한 (3)
실패( 4)
잘못된 매개 변수 (5)
메서드 매개 변수 확인 - 작업 시작 (4096)
크기가 지원되지 않음 (4097)
사용 가능한 공간이 충분하지 않음 (40000)
액세스 거부됨 (40001)
작업을 완료하는 데 충분한 리소스가 없습니다. (40002)
예기치 않은 I/O 오류가 발생했습니다. (40004)
Size 또는 UseMaximumSize 매개 변수를 사용하여 크기를 지정해야 합니다. 이러한 매개 변수 중 하나만 한 번에 지정할 수 있습니다. (40005)
요청된 액세스 경로가 이미 사용 중입니다. (42002)
액세스 경로가 잘못되었습니다. (42007)
지정된 파일 시스템은 지원되지 않습니다. (43001)
볼륨의 서식을 빠르게 지정할 수 없습니다. (43002)
드라이브를 읽는 경우에만 요청된 작업을 수행할 수 없습니다. (43006)
이 볼륨의 이름을 지정해야 합니다. (43017)
이 볼륨을 노출할 파일 서버를 지정해야 합니다. (43018)
볼륨이 지정된 파일 서버에 노출되지 않습니다. (43019)
스토리지 공급자에 연결할 수 없습니다. (46000)
스토리지 공급자는 스토리지 하위 시스템에 연결할 수 없습니다. (46001)
이 스토리지 개체에 대해 장애 조치(failover) 클러스터링 사용할 수 없습니다. (46008)
이 작업은 기본 스토리지 풀에서 지원되지 않습니다. (48000)
스토리지 풀은 특별한 용도로만 예약되어 있습니다. (48001)
지정된 복원력 설정은 이 스토리지 풀에서 지원되지 않습니다. (48002)
스토리지 풀에 지정된 가상 디스크 구성을 만드는 데 실제 디스크가 충분하지 않습니다. (48004)
스토리지 풀의 상태 또는 작동 상태 허용하지 않으므로 작업을 완료할 수 없습니다. (48006)
스토리지 풀의 구성이 읽기 전용이므로 작업을 완료할 수 없습니다. (48007)
크기 정보( Size 또는 UseMaximumSize 매개 변수) 또는 계층 정보( StorageTiers 및 StorageTierSizes 매개 변수)를 지정해야 하지만 크기 정보 및 계층 정보는 지정하지 않아야 합니다. (48010)
해당 이름의 복원력 설정이 없습니다. (49000)
NoSinglePointOfFailure 값은 지원되지 않습니다. (49001)
PhysicalDiskRedundancy 값이 지원되는 값 범위를 벗어났습니다. (49002)
NumberOfDataCopies 값이 지원되는 값 범위를 벗어났습니다. (49003)
ParityLayout 값이 지원되는 값 범위를 벗어났습니다. (49004)
Interleave 값이 지원되는 값 범위를 벗어났습니다. (49005)
NumberOfColumns 값이 지원되는 값 범위를 벗어났습니다. (49006)
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8.1 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 R2 [데스크톱 앱만 해당] |
| 네임스페이스 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |