VDS_VOLUME_PROP2 구조체(vds.h)

아티클
03/08/2023

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

볼륨 개체의 속성을 정의합니다. 이 구조체는 볼륨 GUID도 포함한다는 점을 제외하고 VDS_VOLUME_PROP 구조체와 동일합니다.

구문

typedef struct _VDS_VOLUME_PROP2 {
  VDS_OBJECT_ID        id;
  VDS_VOLUME_TYPE      type;
  VDS_VOLUME_STATUS    status;
  VDS_HEALTH           health;
  VDS_TRANSITION_STATE TransitionState;
  ULONGLONG            ullSize;
  ULONG                ulFlags;
  VDS_FILE_SYSTEM_TYPE RecommendedFileSystemType;
  ULONG                cbUniqueId;
  LPWSTR               pwszName;
  BYTE                 *pUniqueId;
} VDS_VOLUME_PROP2, *PVDS_VOLUME_PROP2;

멤버

id

볼륨의 GUID입니다.

type

볼륨 형식을 지정하는 VDS_VOLUME_TYPE 열거형 값입니다. 볼륨 유형은 단순, 스팬, 스트라이프(RAID-0), 미러링되거나 패리티가 있는 스트라이프(RAID-5)입니다.

status

볼륨의 상태 지정하는 VDS_VOLUME_STATUS 열거형 값입니다.

health

볼륨의 상태를 지정하는 VDS_HEALTH 열거형 값입니다.

TransitionState

볼륨의 전환 상태를 지정하는 VDS_TRANSITION_STATE 열거형 값입니다.

ullSize

볼륨의 크기(바이트)입니다.

ulFlags

볼륨을 설명하는 VDS_VOLUME_FLAG 열거형 값의 비트 마스크입니다.

RecommendedFileSystemType

볼륨의 기본 설정 파일 시스템을 지정하는 VDS_FILE_SYSTEM_TYPE 열거형 값입니다. VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32, VDS_FST_UDF, VDS_FST_CDFS 또는 VDS_FST_UNKNOWN 중 하나여야 합니다.

cbUniqueId

pUniqueId 멤버가 가리키는 바이트 배열의 길이입니다.

pwszName

CreateFile 함수를 사용하여 볼륨에 대한 핸들을 여는 데 사용된 이름입니다. 예를 들어 \?\GLOBALROOT\Device\HarddiskVolume1입니다.

pUniqueId

볼륨의 고유 식별자를 포함하는 바이트 배열입니다.

설명

IVdsVolume2::GetProperties2 메서드는 볼륨 개체의 속성을 보고하기 위해 이 구조를 반환합니다.

볼륨이 오프라인 상태이면 VDS_VF_PERMANENTLY_DISMOUNTED 플래그가 VDS_VOLUME_PROP2 구조체의 ulFlags 멤버에 설정되고 VDS_VS_OFFLINE 볼륨 상태 값도 이 구조체의 상태 멤버에 설정됩니다.

GPT 및 동적 볼륨의 경우 pUniqueId 멤버가 가리키는 고유 식별자는 전역적으로 고유합니다.

이동식 미디어 드라이브의 경우 볼륨이 존재하며 디바이스에 미디어가 없더라도 고유한 식별자가 있습니다. 볼륨이 이동식 미디어에 서식이 지정된 경우 해당 볼륨에는 고유한 식별자가 있습니다. 자세한 내용은 스토리지 클래스 드라이버에서 탑재 관리자 요청 지원을 참조하세요.

고유 식별자의 형식은 다양한 유형의 디바이스 및 볼륨에 따라 달라질 수 있습니다. MBR 디스크의 기본 볼륨의 경우 고유 식별자는 디스크 서명 및 파티션 오프셋을 기반으로 합니다. 디스크 서명 및 파티션 오프셋은 DWORD 값이므로 컴퓨터에서 고유 식별자가 전역적으로 고유하도록 보장할 수 없습니다.

디스크 서명이 변경되면 볼륨의 고유 식별자도 변경됩니다. 디스크 서명 변경은 일반적으로 디스크 복제 중 충돌로 인해 발생합니다.

고유 식별자는 볼륨 GUID 경로와 동일하지 않습니다. 볼륨의 볼륨 GUID 경로를 찾으려면 IVdsVolumeMF3::QueryVolumeGuidPathnames 메서드를 사용합니다.

요구 사항

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