Поделиться через

Метод 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