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
Commdlg.h (include Windows.h)

Weitere Informationen

Referenz

GetOpenFileName

GetSaveFileName

OPENFILENAME

Konzeptionellen

Allgemeine Dialogfeldbibliothek