CDM_GETSPEC Nachricht

  • Artikel

[Ab Windows Vista wurden die allgemeinen Dialogfelder Öffnen und Speichern unter durch das Dialogfeld "Gemeinsame Elemente" ersetzt. Es wird empfohlen, anstelle dieser Dialogfelder aus der Common Dialog Box Library die API für allgemeine Elemente zu verwenden.]

Ruft den Dateinamen (ohne Den Pfad) der aktuell ausgewählten Datei in einem Explorer Dialogfeld Öffnen oder Speichern unter ab. Das Dialogfeld muss mit dem Flag "OFN_EXPLORER " erstellt worden sein. Andernfalls schlägt die Meldung fehl.

#define WM_USER                  0x0400
#define CDM_FIRST               (WM_USER + 100)
#define CDM_GETSPEC             (CDM_FIRST + 0x0000)

Parameter

wParam

Die Größe des lParam-Puffers in Zeichen.

lParam

Ein Zeiger auf den Puffer, der den Dateinamen empfängt.

Rückgabewert

Wenn die Nachricht erfolgreich ist, ist der Rückgabewert die Größe der Dateinamenzeichenfolge in Zeichen, einschließlich des abschließenden NULL-Zeichens. Dies ist entweder die Anzahl der 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).

Bemerkungen

Das entsprechende Makro lautet wie folgt:

int CommDlg_OpenSave_GetSpec(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 (Einschließen von Windows.h)

Siehe auch

Referenz

GetOpenFileName

GetSaveFileName

OPENFILENAME

Konzept

Allgemeine Dialogfeldbibliothek