CDM_GETFILEPATH message

  • Article

[À compter de Windows Vista, les boîtes de dialogue Ouvrir et Enregistrer en tant que communes ont été remplacées par la boîte de dialogue Élément commun. Nous vous recommandons d’utiliser l’API Common Item Dialog au lieu de ces boîtes de dialogue à partir de la bibliothèque de boîtes de dialogue commune.]

Récupère le chemin d’accès et le nom du fichier sélectionné dans une boîte de dialogue Ouvrir ou Enregistrer sous de style Explorer. La boîte de dialogue doit avoir été créée avec l’indicateur OFN_EXPLORER ; sinon, le message échoue.

#define WM_USER                  0x0400
#define CDM_FIRST               (WM_USER + 100)
#define CDM_GETFILEPATH         (CDM_FIRST + 0x0001)

Paramètres

wParam

Taille, en caractères, de la mémoire tampon lParam . Pour la version ANSI, il s’agit du nombre d’octets ; pour la version Unicode, il s’agit du nombre de caractères.

lParam

Pointeur vers la mémoire tampon qui reçoit le nom du fichier et le chemin d’accès.

Valeur retournée

Si le message réussit, la valeur de retour est la taille, en caractères, du nom de fichier et de la chaîne de chemin d’accès, y compris le caractère NULL de fin. Il s’agit du nombre d’octets ou de caractères copiés dans la mémoire tampon, ou de la taille de mémoire tampon requise si la mémoire tampon est trop petite.

Si une erreur se produit, la valeur de retour est inférieure à zéro.

Notes

La macro correspondante est la suivante :

int CommDlg_OpenSave_GetFilePath(hwnd, lparam, wparam);

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows 2000 Server [applications de bureau uniquement]
En-tête
Commdlg.h (inclure Windows.h)

Voir aussi

Référence

GetOpenFileName

GetSaveFileName

OPENFILENAME

Conceptuel

Bibliothèque de boîtes de dialogue commune