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

  • Article

[À 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 vdshwprv.h
Bibliothèque Uuid.lib

Voir aussi

IEnumVdsObject