CDM _ GETFILEPATH-Nachricht
[Ab Windows Vista wurden die allgemeinen Dialogfelder Öffnen und Speichern unter durch den Allgemeinen Elementdialog ersetzt. Es wird empfohlen, anstelle dieser Dialogfelder aus der Common Dialog Box Library die API für den Allgemeinen Elementdialog zu verwenden.]
Ruft den Pfad und den Dateinamen der ausgewählten Datei im Dialogfeld Öffnen oder Speichern unter im Explorer-Stil ab. Das Dialogfeld muss mit dem _ OFN-EXPLORER-Flag erstellt worden sein. Andernfalls schlägt die Meldung fehl.
#define WM_USER 0x0400
#define CDM_FIRST (WM_USER + 100)
#define CDM_GETFILEPATH (CDM_FIRST + 0x0001)
Parameter
-
wParam
-
Die Größe des lParam-Puffers in Zeichen. Für die ANSI-Version ist dies die Anzahl von Bytes. für die Unicode-Version ist dies die Anzahl der Zeichen.
-
lParam
-
Ein Zeiger auf den Puffer, der den Dateinamen und Pfad empfängt.
Rückgabewert
Wenn die Nachricht erfolgreich ist, ist der Rückgabewert die Größe des Dateinamens und der Pfadzeichenfolge in Zeichen, einschließlich des beendenden NULL-Zeichens. Dies ist entweder die Anzahl von Bytes oder Zeichen, die in den Puffer kopiert werden, oder die erforderliche Puffergröße, wenn der Puffer zu klein ist.
Wenn ein Fehler auftritt, ist der Rückgabewert kleiner als 0 (null).
Hinweise
Das entsprechende Makro lautet wie folgt:
int CommDlg_OpenSave_GetFilePath(hwnd, lparam, wparam);
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
Weitere Informationen
-
Referenz
-
Konzeptionellen