Método IVssEnumObject::Next (vss.h)

El método Next devuelve el número especificado de objetos de la lista especificada de objetos enumerados.

Sintaxis

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

Parámetros

[in] celt

Número de elementos que se van a leer de la lista de objetos enumerados en el búfer de rgelt .

[out] rgelt

Dirección de un búfer asignado por el autor de la llamada que recibe celtVSS_OBJECT_PROP estructuras que contienen los objetos devueltos. Este parámetro es obligatorio y no puede ser NULL.

[out] pceltFetched

Número de elementos devueltos en el búfer de rgelt .

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Comentarios

Al solicitar la devolución de más de un objeto VSS_OBJECT_PROP , un valor devuelto de S_FALSE indica que se ha alcanzado el final de la lista de enumeraciones. Si se solicitaron más objetos que permanecer en la lista, Next devolverá todos los objetos restantes, establecerá el parámetro pceltFetched en un valor distinto de cero y devolverá S_FALSE.

El parámetro rgelt de salida debe apuntar a una matriz asignada que contiene estructuras celtVSS_OBJECT_PROP y no puede ser NULL.

Es responsabilidad del autor de la llamada liberar los recursos del sistema devueltos por IVssEnumObject::Next a la estructura de VSS_OBJECT_PROP a la que apunta el parámetro rgelt .

Los llamadores deben usar CoTaskMemFree para cada valor de cadena del objeto VSS_SNAPSHOT_PROP o VSS_PROVIDER_PROP de la estructura de VSS_OBJECT_PROP devuelta.

En el caso de VSS_SNAPSHOT_PROP, esto se puede realizar manualmente o se puede usar la función de utilidad VssFreeSnapshotProperties .

Requisitos

Consulte también

IVssBackupComponents::Query

IVssEnumObject

VSS_OBJECT_PROP