IVdsDisk::QueryExtents 메서드(vds.h)

아티클
03/13/2024

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

디스크의 모든 익스텐트 세부 정보를 반환합니다.

구문

HRESULT QueryExtents(
  [out] VDS_DISK_EXTENT **ppExtentArray,
  [out] LONG            *plNumberOfExtents
);

매개 변수

[out] ppExtentArray

을 수신하는 포인터 변수
VDS_DISK_EXTENT 구조체의 배열입니다. 호출자는 CoTaskMemFree 함수를 사용하여 이 배열을 해제해야 합니다.

[out] plNumberOfExtents

총 익스텐트 수를 나타내는 LONG 형식의 주소입니다.

반환 값

이 메서드는 E_INVALIDARG 또는 E_OUTOFMEMORY 같은 표준 HRESULT 값과 VDS별 반환 값을 반환할 수 있습니다. HRESULT_FROM_WIN32 매크로를 사용하여 변환된 시스템 오류 코드를 반환할 수도 있습니다. 오류는 VDS 자체 또는 사용 중인 기본 VDS 공급자 에서 발생할 수 있습니다. 가능한 반환 값은 다음과 같습니다.

반환 코드/값	Description
S_OK	익스텐트 정보가 성공적으로 반환되었습니다.
VDS_E_PACK_OFFLINE 0x80042444L	디스크가 속한 팩에 액세스할 수 없습니다.

설명

이 메서드를 사용하여 볼륨을 만들거나 확장하는 데 사용할 수 있는 사용 가능한 공간의 양을 결정합니다. 익스텐트 정보를 사용하여 디스크를 차지하는 볼륨 수를 확인할 수도 있습니다. 유효한 익스텐트 유형은 알 수 없는 익스텐트, 사용 가능한 익스텐트, 데이터 익스텐트, OEM 익스텐트, ESP 익스텐트, MSR 익스텐트, LDM 메타데이터 익스텐트 및 사용할 수 없는 익스텐트입니다. 데이터 익스텐트 위에 볼륨에 대한 링크가 포함되어 있습니다.

디스크가 동적 디스크인 경우 온라인이어야 합니다. 기본 디스크 또는 원시 디스크인 경우 온라인 또는 오프라인일 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	vds.h
라이브러리	Uuid.lib