IEnumVdsObject ::Next, méthode (vds.h)

Article
03/03/2024

[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API gestion du stockage Windows.]

Retourne un nombre spécifié d’objets dans l’énumération, en commençant par le point actuel. Pour plus d’informations, consultez Utilisation des objets d’énumération.

Syntaxe

HRESULT Next(
  [in]  ULONG    celt,
  [out] IUnknown **ppObjectArray,
  [out] ULONG    *pcFetched
);

Paramètres

[in] celt

Nombre d’objets à retourner.

[out] ppObjectArray

Adresse d’un tableau de pointeurs IUnknown , que VDS initialise au retour.

[out] pcFetched

Adresse d’un ULONG, que VDS initialise en retournant au nombre d’objets dans ppObjectArray.

Valeur retournée

Cette méthode peut retourner des valeurs HRESULT standard, telles que E_INVALIDARG ou E_OUTOFMEMORY, et des valeurs de retour spécifiques à VDS. Il peut également retourner des codes d’erreur système convertis à l’aide de la macro HRESULT_FROM_WIN32 . Les erreurs peuvent provenir de VDS lui-même ou du fournisseur VDS sous-jacent utilisé. Les valeurs de retour possibles sont les suivantes.

Code de retour	Description
S_OK	La méthode a retourné le nombre spécifié d’objets. Le nombre d’objets retournés dans pcFetched est égal à celte ; retourne ces objets.
S_FALSE	Le nombre spécifié d’objets retournés est supérieur au nombre d’objets restants. Tous les objets restants sont retournés, et le nombre d’objets retournés dans pcFetched est inférieur à celte ; retourne ces objets.

Remarques

Pour obtenir des pointeurs d’interface spécifiques à l’objet à partir des pointeurs IUnknown retournés dans le tableau ppObjectArray , utilisez la méthode IUnknown ::QueryInterface .

Configuration requise

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

Voir aussi

IEnumVdsObject

Partager via