Fonction DragQueryFileA (shellapi.h)
Récupère les noms des fichiers supprimés résultant 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 de fichier avec la valeur correspondante vers la mémoire tampon pointée par 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 est 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 de retour
Type : uiNT
Une valeur différente de zéro indique un appel réussi.
Lorsque la fonction copie un nom de fichier dans la mémoire tampon, la valeur de retour est un 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 des 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 que l’adresse de la mémoire tampon lpszFile est NULL, la valeur de retour est la taille requise, en caractères, de la mémoire tampon, ne pas inclure le caractère null de fin.
Remarques
Note
L’en-tête shellapi.h définit DragQueryFile comme 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’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) |