CDM_GETSPEC 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 nom de fichier (sans le chemin d’accès) du fichier actuellement 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_GETSPEC             (CDM_FIRST + 0x0000)

Paramètres

wParam

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

lParam

Pointeur vers la mémoire tampon qui reçoit le nom du fichier.

Valeur retournée

Si le message réussit, la valeur de retour correspond à la taille, en caractères, de la chaîne de nom de fichier, 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_GetSpec(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