LB _ DIR-Nachricht

Fügt der Liste, die von einem Listenfeld angezeigt wird, Namen hinzu. Die Meldung fügt die Namen von Verzeichnissen und Dateien hinzu, die mit einer angegebenen Zeichenfolge und einem Satz von Dateiattributen übereinstimmen. LB _ DIR kann dem Listenfeld auch zugeordnete Laufwerkbuchstaben hinzufügen.

Parameter

wParam

Die Attribute der Dateien oder Verzeichnisse, die dem Listenfeld hinzugefügt werden sollen. Dieser Parameter kann einen oder mehrere der folgenden Werte sein.

Wert Bedeutung
DDL _ ARCHIVE
Schließt archivierte Dateien ein.
_DDL-VERZEICHNIS
Schließt Unterverzeichnisse ein. Unterverzeichnisnamen werden in eckige Klammern () [ ] eingeschlossen.
_DDL-LAUFWERKE
Alle zugeordneten Laufwerke werden der Liste hinzugefügt. Laufwerke werden im Formular [ - x - ] aufgeführt, wobei x der Laufwerkbuchstaben ist.
DDL _ EXCLUSIVE
Schließt nur Dateien mit den angegebenen Attributen ein. Standardmäßig werden Lese-/Schreibdateien auch dann aufgelistet, wenn DDL _ READWRITE nicht angegeben ist.
DDL _ HIDDEN
Schließt ausgeblendete Dateien ein.
DDL _ READONLY
Schließt schreibgeschützte Dateien ein.
DDL _ READWRITE
Schließt Lese-/Schreibdateien ohne zusätzliche Attribute ein. Dies ist die Standardeinstellung.
_DDL-SYSTEM
Schließt Systemdateien ein.

lParam

Ein Zeiger auf die auf NULL beendete Zeichenfolge, die einen absoluten Pfad, relativen Pfad oder Dateinamen angibt. Ein absoluter Pfad kann mit einem Laufwerkbuchstaben beginnen (z. B. d: oder einem UNC-Namen (z. B. ) \ \ machinename \ sharename).

Wenn die Zeichenfolge einen Dateinamen oder ein Verzeichnis mit den attributen angibt, die vom wParam-Parameter angegeben werden, wird der Dateiname oder das Verzeichnis der Liste hinzugefügt. Wenn der Dateiname oder Verzeichnisname Platzhalterzeichen enthält (? oder ), werden alle Dateien oder Verzeichnisse, die mit dem Platzhalterausdruck übereinstimmen und über die vom * wParam-Parameter angegebenen Attribute verfügen, der Liste hinzugefügt.

Rückgabewert

Wenn die Nachricht erfolgreich ist, ist der Rückgabewert der nullbasierte Index des Nachnamens, der der Liste hinzugefügt wurde.

Wenn ein Fehler auftritt, ist der Rückgabewert LB _ ERR. Wenn nicht genügend Speicherplatz zum Speichern der neuen Zeichenfolgen verfügbar ist, ist der Rückgabewert LB _ ERRSPACE.

Hinweise

Die LB _ INITSTORAGE-Nachricht beschleunigt die Initialisierung von Listenfeldern mit einer großen Anzahl von Elementen (mehr als 100). Die angegebene Arbeitsspeichermenge wird reserviert, sodass nachfolgende LB _ DIR-Nachrichten so kurz 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 zugeordnet. Wenn Sie zu viele Überschreitungen haben, wird die normale Zuordnung für Elemente verwendet, die den angeforderten Betrag überschreiten.

Wenn wParam das DDL DIRECTORY-Flag enthält und lParam alle Unterverzeichnisse eines Verzeichnisses der ersten Ebene angibt, z. B. C: TEMP, enthält das Listenfeld immer einen _ Eintrag \ \ * ".." für das Stammverzeichnis. Dies gilt auch, wenn das Stammverzeichnis über ausgeblendete Attribute oder Systemattribute verfügt und die Flags DDL HIDDEN und _ DDL _ SYSTEM nicht angegeben sind. Das Stammverzeichnis eines NTFS-Volumes verfügt über ausgeblendete - und -Systemattribute.

In der Liste werden lange Dateinamen (sofern verfügbar) angezeigt.

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 akzentierte romanische Zeichen in einem Nicht-Unicode-Listenfeld auf japanisch Windows geschachtelt angezeigt. Kompilieren Sie die Anwendung entweder als Unicode, oder verwenden Sie ein vom Besitzer gezeichnetes Listenfeld, um dieses Problem zu beheben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Winuser.h (include Windows.h)

Weitere Informationen

DlgDirList