LB_ADDFILE Nachricht

Fügt den angegebenen Dateinamen einem Listenfeld hinzu, das eine Verzeichnisliste enthält.

Parameter

wParam

Dieser Parameter wird nicht verwendet.

lParam

Ein Zeiger auf einen Puffer, der den Namen der hinzuzufügenden Datei angibt.

Rückgabewert

Der Rückgabewert ist der nullbasierte Index der hinzugefügten Datei oder LB_ERR, wenn ein Fehler auftritt.

Bemerkungen

Das Listenfeld, dem lParam hinzugefügt wird, muss von der DlgDirList-Funktion ausgefüllt worden sein.

Die LB_INITSTORAGE Nachricht trägt dazu bei, die Initialisierung von Listenfeldern zu beschleunigen, die eine große Anzahl von Elementen (mehr als 100) aufweisen. Es reserviert die angegebene Menge an Arbeitsspeicher, sodass nachfolgende LB_ADDFILE Nachrichten so schnell wie möglich dauern. Sie können Schätzungen für die Parameter wParam und lParam verwenden. Wenn Sie überschätzen, wird der zusätzliche Arbeitsspeicher zugewiesen. wenn Sie unterschätzen, wird die normale Zuordnung für Elemente verwendet, die den angeforderten Betrag überschreiten.

Bei einer ANSI-Anwendung konvertiert das System den Text in einem Listenfeld mithilfe von CP_ACP in Unicode. Dies kann zu Problemen führen. Beispielsweise werden römische Zeichen mit Akzenten in einem Nicht-Unicode-Listenfeld in japanischen Windows verworren. Um dies zu beheben, kompilieren Sie entweder die Anwendung als Unicode, oder verwenden Sie ein vom Besitzer gezeichnetes Listenfeld.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Winuser.h (einschließlich Windows.h)

Weitere Informationen

Referenz

DlgDirList

LB_ADDSTRING