Metodo IVssEnumObject::Next (vss.h)

Il metodo Next restituisce il numero specificato di oggetti dall'elenco specificato di oggetti enumerati.

Sintassi

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

Parametri

[in] celt

Numero di elementi da leggere dall'elenco di oggetti enumerati nel buffer rgelt .

[out] rgelt

Indirizzo di un buffer allocato dal chiamante che riceve strutture VSS_OBJECT_PROPcelt che contengono gli oggetti restituiti. Questo parametro è obbligatorio e non può essere NULL.

[out] pceltFetched

Numero di elementi restituiti nel buffer rgelt .

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Commenti

Quando si richiede la restituzione di più di un oggetto VSS_OBJECT_PROP , un valore restituito di S_FALSE indica che la fine dell'elenco di enumerazione è stata raggiunta. Se sono stati richiesti più oggetti rispetto a quelli rimasti nell'elenco, Next restituirà tutti gli oggetti rimanenti, impostare il parametro pceltFetched su un valore diverso da zero e restituire S_FALSE.

Il parametro rgelt di output deve puntare a una matrice allocata contenente strutture VSS_OBJECT_PROPcelt e non può essere NULL.

È responsabilità del chiamante liberare le risorse di sistema restituite da IVssEnumObject::Next alla struttura VSS_OBJECT_PROP puntata dal parametro rgelt .

I chiamanti devono usare CoTaskMemFree per ogni valore stringa nell'oggetto VSS_SNAPSHOT_PROP o VSS_PROVIDER_PROPnella struttura VSS_OBJECT_PROP restituita.

Nel caso di VSS_SNAPSHOT_PROP, questa operazione può essere eseguita manualmente o la funzione di utilità VssFreeSnapshotProperties può essere usata.

Requisiti

Vedi anche

IVssBackupComponents::Query

IVssEnumObject

VSS_OBJECT_PROP