Fonction DragQueryFileA (shellapi.h)

Récupère les noms des fichiers supprimés qui résultent d’une opération de glisser-déplacer réussie.

Syntaxe

UINT DragQueryFileA(
  [in]  HDROP hDrop,
  [in]  UINT  iFile,
  [out] LPSTR lpszFile,
        UINT  cch
);

Paramètres

[in] hDrop

Type : HDROP

Identificateur de la structure qui contient les noms de fichiers des fichiers supprimés.

[in] iFile

Type : UINT

Index du fichier à interroger. Si la valeur de ce paramètre est 0xFFFFFFFF, DragQueryFile retourne le nombre de fichiers supprimés. Si la valeur de ce paramètre est comprise entre zéro et le nombre total de fichiers supprimés, DragQueryFile copie le nom du fichier avec la valeur correspondante dans la mémoire tampon vers laquelle pointe le paramètre lpszFile .

[out] lpszFile

Type : LPTSTR

Adresse d’une mémoire tampon qui reçoit le nom de fichier d’un fichier supprimé lorsque la fonction retourne. Ce nom de fichier est une chaîne terminée par null. Si ce paramètre a la valeur NULL, DragQueryFile retourne la taille requise, en caractères, de cette mémoire tampon.

cch

Type : UINT

Taille, en caractères, de la mémoire tampon lpszFile .

Valeur retournée

Type : UINT

Une valeur différente de zéro indique un appel réussi.

Lorsque la fonction copie le nom d’un fichier dans la mémoire tampon, la valeur renvoyée correspond au nombre de caractères copiés, sans inclure le caractère null de fin.

Si la valeur d’index est 0xFFFFFFFF, la valeur de retour est un nombre de fichiers supprimés. Notez que la variable d’index elle-même retourne inchangée et reste donc 0xFFFFFFFF.

Si la valeur d’index est comprise entre zéro et le nombre total de fichiers supprimés, et si l’adresse de mémoire tampon lpszFile est NULL, la valeur de retour correspond à la taille requise, en caractères, de la mémoire tampon, sans compter le caractère null de fin.

Remarques

Notes

L’en-tête shellapi.h définit DragQueryFile 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 XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shellapi.h
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 4.0 ou ultérieure)
Ensemble d’API	ext-ms-win-shell-shell32-l1-2-1 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

DragQueryPoint