FilterGetDosName, fonction (fltuser.h)

Article
02/26/2024

La fonction FilterGetDosName retourne le nom de l’appareil MS-DOS qui correspond au nom de volume donné.

Syntaxe

HRESULT FilterGetDosName(
  [in]  LPCWSTR lpVolumeName,
  [out] LPWSTR  lpDosName,
  [in]  DWORD   dwDosNameBufferSize
);

Paramètres

[in] lpVolumeName

Pointeur vers une chaîne de caractères larges terminée par NULL contenant le nom du volume.

La chaîne d’entrée lpVolumeName peut être l’une des valeurs suivantes. La barre oblique inverse de fin (\) est facultative.

Une lettre de lecteur, telle que « D :\ »
Chemin d’accès à un point de montage de volume, tel que « c :\mnt\edrive\ »
Un identificateur de volume unique (également appelé nom GUID de volume), tel que « \ ? » \Volume{7603f260-142a-11d4-ac67-806d6172696f}\ »
Un nom d’appareil non persistant (également appelé nom de cible ou nom d’appareil NT), tel que « \Device\HarddiskVolume1\ »

Ce paramètre est obligatoire et ne peut pas être NULL.

[out] lpDosName

Pointeur vers une mémoire tampon allouée à l’appelant qui reçoit le nom de l’appareil MS-DOS sous la forme d’une chaîne de caractères larges terminée par null.

[in] dwDosNameBufferSize

Taille, en caractères larges, de la mémoire tampon vers laquelle lpDosName pointe.

Valeur retournée

FilterGetDosName retourne S_OK en cas de réussite. Sinon, elle retourne une valeur d’erreur.

Remarques

FilterGetDosName retourne la lettre de lecteur du volume, le cas échéant. Si aucune lettre de lecteur n’est affectée au volume, FilterGetDosName retourne un chemin d’accès à un point de montage de volume (également appelé nom de point de montage). Si aucune lettre de lecteur ou point de montage n’est défini pour le volume, FilterGetDosName retourne S_OK et lpDosName reçoit NULL.