IVssEnumObject ::Next, méthode (vss.h)

Article
03/03/2024

La méthode Next retourne le nombre spécifié d’objets à partir de la liste spécifiée d’objets énumérés.

Syntaxe

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

Paramètres

[in] celt

Nombre d’éléments à lire à partir de la liste des objets énumérés dans la mémoire tampon rgelt .

[out] rgelt

Adresse d’une mémoire tampon allouée à l’appelant qui reçoit celtVSS_OBJECT_PROP structures qui contiennent les objets retournés. Ce paramètre est obligatoire et ne peut pas être NULL.

[out] pceltFetched

Nombre d’éléments retournés dans la mémoire tampon rgelt .

Valeur retournée

Voici les codes de retour valides pour cette méthode.

Valeur	Signification
S_OK	L'opération a réussi.
S_FALSE	Le nombre d’éléments retournés est inférieur au nombre demandé.
E_FAIL	Il existe une erreur interne dans l’énumérateur.
E_POINTER	L’un des paramètres de pointeur requis est NULL.

Remarques

Lorsque vous demandez le retour de plusieurs VSS_OBJECT_PROP objet, une valeur de retour de S_FALSE indique que la fin de la liste d’énumération a été atteinte. Si plus d’objets ont été demandés que dans la liste, Next retourne tous les objets restants, définit le paramètre pceltFetched sur une valeur différente de zéro et retourne S_FALSE.

Le paramètre rgelt de sortie doit pointer vers un tableau alloué contenant des structures VSS_OBJECT_PROPcelt et ne peut pas être NULL.

Il incombe à l’appelant de libérer les ressources système retournées par IVssEnumObject ::En regard de la structure VSS_OBJECT_PROP pointée par le paramètre rgelt .

Les appelants doivent utiliser CoTaskMemFree pour chaque valeur de chaîne dans l’objet VSS_SNAPSHOT_PROP ou VSS_PROVIDER_PROP dans la structure VSS_OBJECT_PROP retournée.

Dans le cas de VSS_SNAPSHOT_PROP, cette opération peut être effectuée manuellement ou la fonction utilitaire VssFreeSnapshotProperties peut être utilisée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vss.h
Bibliothèque	VssApi.lib

Voir aussi

IVssBackupComponents ::Query

IVssEnumObject

VSS_OBJECT_PROP

Partager via