GetVolumesFromDriveA, fonction (ntmsapi.h)

[Le Gestionnaire de stockage amovible n’est plus disponible à partir de Windows 7 et Windows Server 2008 R2.]

La fonction GetVolumesFromDrive récupère le volume et la lettre de lecteur pour un lecteur multimédia de stockage amovible donné.

Syntaxe

DWORD GetVolumesFromDriveA(
  [in]  LPSTR pszDriveName,
  [out] LPSTR *VolumeNameBufferPtr,
  [out] LPSTR *DriveLetterBufferPtr
);

Paramètres

[in] pszDriveName

Nom du lecteur multimédia de stockage amovible.

[out] VolumeNameBufferPtr

Volume qui représente le lecteur multimédia de stockage amovible.

[out] DriveLetterBufferPtr

Lettre de lecteur qui représente le lecteur multimédia de stockage amovible.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur système.

Remarques

Cette fonction suppose qu’il n’y aura que zéro ou une partition sur un disque amovible, donc il y a au maximum une lettre de lecteur et un nom de volume.

Notes

L’en-tête ntmsapi.h définit GetVolumesFromDrive comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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	ntmsapi.h
Bibliothèque	Ntmsapi.lib
DLL	Ntmsapi.dll

Voir aussi

GetNtmsObjectInformation

Fonctions de contrôle de bibliothèque