Metodo IVssEnumObject::Next (vss.h)

  • Articolo

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.

Valore Significato
S_OK
 L'operazione è stata completata.
S_FALSE
 Il numero di elementi restituiti è minore del numero richiesto.
E_FAIL
 Si verifica un errore interno nell'enumeratore.
E_POINTER
 Uno dei parametri del puntatore richiesto è NULL.

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

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione vss.h
Libreria VssApi.lib

Vedi anche

IVssBackupComponents::Query

IVssEnumObject

VSS_OBJECT_PROP