MSFT_StoragePool 클래스의 GetSupportedSize 메서드
스토리지 풀에서 만들 수 있는 지원되는 가상 디스크 크기를 검색합니다.
이러한 크기는 다음 방법 중 하나 또는 둘 다에서 반환할 수 있습니다.
- SupportedSizes 매개 변수에서 지원되는 모든 크기의 배열입니다.
- VirtualDiskSizeMin, VirtualDiskSizeMax 및 VirtualDiskSizeDivisor 매개 변수로 정의된 범위입니다.
구문
UInt32 GetSupportedSize(
[in] String ResiliencySettingName,
[out] UInt64 SupportedSizes[],
[out] UInt64 VirtualDiskSizeMin,
[out] UInt64 VirtualDiskSizeMax,
[out] UInt64 VirtualDiskSizeDivisor,
[out] String ExtendedStatus
);
매개 변수
ResiliencySettingName [in]
지원되는 크기를 결정할 때 사용해야 하는 복원력 설정의 이름입니다. 반환되는 크기는 복원력 설정에 따라 다를 수 있습니다.
SupportedSizes [out]
스토리지 풀에서 지원되는 지원되는 모든 크기(바이트)의 배열입니다. 지원되는 크기 수가 큰 경우 이 매개 변수는 NULL 일 수 있지만 선택한 수의 가상 디스크 크기만 지원하는 스토리지 풀에 유용합니다.
VirtualDiskSizeMin [out]
스토리지 풀에서 만든 가상 디스크의 최소 가상 디스크 크기(바이트)입니다.
VirtualDiskSizeMax [out]
스토리지 풀에서 만든 가상 디스크의 최대 가상 디스크 크기(바이트)입니다.
VirtualDiskSizeDivisor [out]
가상 디스크 크기를 결정할 때 사용해야 하는 승수를 지정합니다. 만들기 또는 수정 작업에 지정된 모든 크기는 이 값의 배수여야 합니다.
예를 들어 지원되는 최소 크기가 10GB이고 이 매개 변수가 2GB인 경우 지원되는 최대 크기에 도달할 때까지 이 풀에 지원되는 크기는 10GB, 12GB, 14GB 등입니다.
ExtendedStatus [out]
포함된 MSFT_StorageExtendedStatus 개체를 포함하는 문자열입니다.
이 매개 변수를 사용하면 스토리지 공급자가 확장(구현별) 오류 정보를 반환할 수 있습니다.
반환 값
성공 (0)
지원되지 않음 (1)
지정되지 않은 오류 (2)
시간 제한 (3)
실패( 4)
잘못된 매개 변수 (5)
액세스 거부됨 (40001)
작업을 완료하는 데 충분한 리소스가 없습니다. (40002)
캐시 만료( 40003)
스토리지 공급자에 연결할 수 없습니다. (46000)
스토리지 공급자가 스토리지 하위 시스템에 연결할 수 없습니다. (46001)
설명
이 메서드가 반환하는 값은 스토리지 풀의 현재 상태와 사용 가능한 스토리지 용량을 반영해야 합니다. SupportedSizes에서 반환되는 모든 값은 VirtualDiskSizeDivisor의 배수여야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 네임스페이스 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |