Méthode IVdsLun2::ApplyHints2 (vds.h)

Article
03/08/2023

[À 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.]

Applique un nouvel ensemble d’indicateurs au numéro d’unité logique. Les indicateurs appliqués à un numéro d’unité logique sont appliqués simultanément à tous les plex. Cette méthode est identique à la méthode IVdsLun::ApplyHints , sauf qu’elle utilise une structure VDS_HINTS2 au lieu d’une structure VDS_HINTS .

Syntaxe

HRESULT ApplyHints2(
  [in] VDS_HINTS2 *pHints2
);

Paramètres

[in] pHints2

Pointeur vers les nouveaux indicateurs à appliquer au numéro d’unité logique. Consultez la structure VDS_HINTS2 .

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/valeur de retour	Description
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	Il existe un problème logiciel ou de communication à l’intérieur d’un fournisseur qui met en cache des informations sur le tableau. Utilisez la méthode IVdsHwProvider::Reenumerate suivie de la méthode IVdsHwProvider::Refresh pour restaurer le cache.
VDS_E_OBJECT_DELETED 0x8004240BL	L’objet LUN n’est plus présent.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	Le numéro d’unité logique est en état d’échec et ne peut pas effectuer l’opération demandée.
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	Une autre opération est en cours. Cette opération ne peut pas continuer tant que l’opération précédente ou les opérations ne sont pas terminées.
VDS_E_NOT_SUPPORTED 0x80042400L	Cette opération ou cette combinaison de paramètres n’est pas prise en charge par ce fournisseur.

Remarques

Les appelants peuvent également spécifier des indicateurs en passant le paramètre pHints à la méthode IVdsSubSystem2::CreateLun2 lors de la création d’un numéro d’unité logique. Pour rechercher des indicateurs existants, utilisez la méthode IVdsLun2::QueryHints2 .

Configuration requise


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vds.h
Bibliothèque	Uuid.lib