Compartir a través de

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

  • Artículo

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.

Valor Significado
S_OK
 La operación se realizó correctamente.
S_FALSE
 El número de elementos devueltos es menor que el número solicitado.
E_FAIL
 Hay un error interno en el enumerador.
E_POINTER
 Uno de los parámetros de puntero necesarios es NULL.

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

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vss.h
Library VssApi.lib

Consulte también

IVssBackupComponents::Query

IVssEnumObject

VSS_OBJECT_PROP