IVdsHwProviderStoragePools::QueryStoragePools 메서드(vds.h)

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

하드웨어 공급자가 관리하는 스토리지 풀 목록을 포함하는 IEnumVdsObject 열거형 개체를 반환합니다.

구문

HRESULT QueryStoragePools(
  [in]  ULONG               ulFlags,
  [in]  ULONGLONG           ullRemainingFreeSpace,
  [in]  VDS_POOL_ATTRIBUTES *pPoolAttributes,
  [out] IEnumVdsObject      **ppEnum
);

매개 변수

[in] ulFlags

쿼리할 스토리지 풀의 유형을 지정하는 하나 이상의 VDS_STORAGE_POOL_TYPE 플래그 비트 마스크입니다. 플래그 중 하나는 VDS_SPT_CONCRETE 또는 VDS_SPT_PRIMORDIAL. 이 매개 변수의 기본값은 0입니다. 값이 0이면 모든 스토리지 풀을 쿼리해야 합니다.

[in] ullRemainingFreeSpace

각 스토리지 풀에 포함해야 하는 최소 사용 가능한 공간 크기(바이트)입니다. 이 매개 변수의 기본값은 0입니다. 값이 0이면 스토리지 풀에 사용 가능한 공간이 포함될 수 있습니다.

[in] pPoolAttributes

반환된 스토리지 풀에 있어야 하는 특성 값을 지정하는 VDS_POOL_ATTRIBUTES 구조체에 대한 포인터입니다. 이 매개 변수의 기본값은 NULL입니다. NULL 값은 스토리지 풀에 특성 값이 있을 수 있음을 의미합니다.

[out] ppEnum

스토리지 풀을 열거하는 데 사용할 수 있는 IEnumVdsObject 인터페이스 포인터의 주소입니다. 자세한 내용은 열거형 개체 작업을 참조하세요. 호출자는 IUnknown::Release 메서드를 호출하여 더 이상 필요하지 않은 경우 인터페이스와 각 스토리지 풀 개체를 해제해야 합니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

반환 값

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

반환 코드	Description
S_OK	메서드가 완료되었습니다.

설명

하드웨어 공급자가 스토리지 풀을 관리하지 않는 경우 이 메서드는 빈 열거형 개체를 반환합니다.

nULL이 아닌 값이 pPoolAttributes 매개 변수에 지정된 경우 이 메서드는 VDS_POOL_ATTRIBUTES 구조에 지정된 모든 특성을 충족하는 스토리지 풀만 반환합니다. 최소 및 최대 특성이 지정된 경우 반환되는 스토리지 풀은 이러한 특성과 정확히 일치해야 합니다. 힌트 특성은 지정된 모든 특성을 충족하는 스토리지 풀을 추가로 필터링하기 위한 힌트로 사용됩니다. 지정된 특성이 스토리지 풀에 적용되지 않는 경우 이 메서드는 빈 열거형 개체가 있는 S_OK 반환합니다.

요구 사항

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

추가 정보

IVdsHwProviderStoragePools