Метод 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 ненулевое значение и вернет S_FALSE.

Параметр output rgelt должен указывать на выделенный массив, содержащий структуры celtVSS_OBJECT_PROP , и не может иметь значение NULL.

Именно вызывающий объект отвечает за освобождение системных ресурсов, возвращаемых IVssEnumObject::Рядом с VSS_OBJECT_PROP структурой, на которую указывает параметр rgelt .

Вызывающие объекты должны использовать CoTaskMemFree для каждого строкового значения в VSS_SNAPSHOT_PROP или VSS_PROVIDER_PROP объекта в возвращаемой VSS_OBJECT_PROP структуре.

В случае VSS_SNAPSHOT_PROP это можно сделать вручную или использовать служебную функцию VssFreeSnapshotProperties .

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	vss.h
Библиотека	VssApi.lib

См. также раздел

IVssBackupComponents::Query

IVssEnumObject

VSS_OBJECT_PROP