Partager via


Méthode IVdsLunNaming ::SetFriendlyName (vdshwprv.h)

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

Définit le nom convivial d’une LUN.

Syntaxe

HRESULT SetFriendlyName(
  LPWSTR pwszFriendlyName
);

Paramètres

pwszFriendlyName

Pointeur vers une chaîne terminée par null spécifiant le nom à affecter au LUN.

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
S_OK
Le nom a été correctement défini.
VDS_S_NAME_TRUNCATED
0x00042700L
Le nom a été défini avec succès, mais a dû être tronqué en raison de limitations dans le sous-système. Le nom défini peut ne pas correspondre au nom passé dans le paramètre pwszName .
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
Le cache du fournisseur est endommagé. Cela indique un problème logiciel ou de communication à l’intérieur d’un fournisseur qui met en cache des informations sur les appareils attachés. L’appelant peut utiliser 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 LUN est dans un état d’échec et n’est pas en mesure d’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 se poursuivre tant que les opérations précédentes ne sont pas terminées.
VDS_E_NOT_SUPPORTED
0x80042400L
Cette opération n’est pas prise en charge par ce fournisseur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête vdshwprv.h

Voir aussi

IVdsLunNaming