Méthode IVdsAdvancedDisk ::AssignDriveLetter (vds.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.]

Affecte une lettre de lecteur à une partition OEM, ESP ou inconnue existante.

Syntaxe

HRESULT AssignDriveLetter(
  [in] ULONGLONG ullOffset,
  [in] WCHAR     wcLetter
);

Paramètres

[in] ullOffset

Décalage de partition.

[in] wcLetter

Lettre de lecteur à affecter.

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
 La lettre de lecteur a été attribuée avec succès.
VDS_E_DRIVE_LETTER_NOT_FREE
0x8004255CL
 La lettre de lecteur spécifiée est déjà affectée à une autre partition ou volume.
VDS_E_INVALID_OPERATION
0x80042415L
 La partition se trouve sur un support amovible ; sinon, la partition n’est pas une partition OEM, ESP ou inconnue.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 La partition n’existe pas.

Remarques

VDS implémente cette méthode.

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

Objet Disk

IVdsAdvancedDisk