IVssEnumObject ::Next, méthode (vss.h)
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 |
---|---|
|
L'opération a réussi. |
|
Le nombre d’éléments retournés est inférieur au nombre demandé. |
|
Il existe une erreur interne dans l’énumérateur. |
|
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour