Share via

IEnumVdsObject::Next 메서드(vds.h)

  • 아티클

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

현재 지점에서 시작하여 열거형에 지정된 수의 개체를 반환합니다. 자세한 내용은 열거형 개체 작업을 참조하세요.

구문

HRESULT Next(
  [in]  ULONG    celt,
  [out] IUnknown **ppObjectArray,
  [out] ULONG    *pcFetched
);

매개 변수

[in] celt

반환할 개체의 수입니다.

[out] ppObjectArray

반환 시 VDS가 초기화하는 IUnknown 포인터 배열의 주소입니다.

[out] pcFetched

VDS가 ppObjectArray의 개체 수로 반환할 때 초기화하는 ULONG의 주소입니다.

반환 값

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

반환 코드 Description
S_OK
 메서드는 지정된 수의 개체를 반환했습니다. pcFetched에서 보고된 반환된 개체의 수는 celt와 같습니다. 는 해당 개체를 반환합니다.
S_FALSE
 반환된 개체의 지정된 수가 남아 있는 개체 수보다 큽습니다. 나머지 개체가 모두 반환되고 pcFetched 에서 반환된 개체 수가 셀트보다 적습니다. 는 해당 개체를 반환합니다.

설명

ppObjectArray 배열에 반환된 IUnknown 포인터에서 개체별 인터페이스 포인터를 가져오려면 IUnknown::QueryInterface 메서드를 사용합니다.

요구 사항

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

추가 정보

IEnumVdsObject