IVssEnumObject::Next 메서드(vss.h)

Next 메서드는 열거된 개체의 지정된 목록에서 지정된 수의 개체를 반환합니다.

구문

HRESULT Next(
  [in]  ULONG           celt,
  [out] VSS_OBJECT_PROP *rgelt,
  [out] ULONG           *pceltFetched
);

매개 변수

[in] celt

열거된 개체 목록에서 rgelt 버퍼로 읽을 요소 수입니다.

[out] rgelt

반환된 개체를 포함하는 celtVSS_OBJECT_PROP 구조를 수신하는 호출자가 할당한 버퍼의 주소입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

[out] pceltFetched

rgelt 버퍼에 반환된 요소의 수입니다.

반환 값

다음은 이 메서드에 대한 유효한 반환 코드입니다.

값	의미
S_OK	작업이 완료되었습니다.
S_FALSE	반환된 항목 수가 요청된 수보다 작습니다.
E_FAIL	열거자에 내부 오류가 있습니다.
E_POINTER	필요한 포인터 매개 변수 중 하나는 NULL입니다.

설명

둘 이상의 VSS_OBJECT_PROP 개체의 반환을 요청할 때 S_FALSE 반환 값은 열거형 목록의 끝에 도달했음을 나타냅니다. 목록에 남아 있는 것보다 더 많은 개체가 요청된 경우 Next 는 나머지 개체를 모두 반환하고 pceltFetched 매개 변수를 0이 아닌 값으로 설정하고 S_FALSE 반환합니다.

출력 rgelt 매개 변수는 셀트VSS_OBJECT_PROP 구조체를 포함하는 할당된 배열을 가리킬 수 있으며 NULL일 수 없습니다.

iVssEnumObject::Next에서 rgelt 매개 변수가 가리키는 VSS_OBJECT_PROP 구조 옆에 반환된 시스템 리소스를 해제하는 것은 호출자의 책임입니다.

호출자는 반환된 VSS_OBJECT_PROP 구조체의 VSS_SNAPSHOT_PROP 또는 VSS_PROVIDER_PROP 개체의 모든 문자열 값에 CoTaskMemFree를 사용해야 합니다.

VSS_SNAPSHOT_PROP 경우 수동으로 수행하거나 유틸리티 함수 VssFreeSnapshotProperties를 사용할 수 있습니다.

요구 사항

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

추가 정보

IVssBackupComponents::Query

IVssEnumObject

VSS_OBJECT_PROP