DlgDirSelectComboBoxExA-Funktion (winuser.h)

Ruft die aktuelle Auswahl aus einem Kombinationsfeld ab, das mithilfe der Funktion DlgDirListComboBox gefüllt wird . Die Auswahl wird als Laufwerkbuchstabe, Datei oder Verzeichnisname interpretiert.

Syntax

BOOL DlgDirSelectComboBoxExA(
  [in]  HWND  hwndDlg,
  [out] LPSTR lpString,
  [in]  int   cchOut,
  [in]  int   idComboBox
);

Parameter

[in] hwndDlg

Typ: HWND

Ein Handle für das Dialogfeld, das das Kombinationsfeld enthält.

[out] lpString

Typ: LPTSTR

Ein Zeiger auf den Puffer, der den ausgewählten Pfad empfängt.

[in] cchOut

Typ: int

Die Länge des Puffers in Zeichen, auf den der lpString-Parameter verweist.

[in] idComboBox

Typ: int

Der ganzzahlige Bezeichner des Kombinationsfeld-Steuerelements im Dialogfeld.

Rückgabewert

Typ: BOOL

Wenn die aktuelle Auswahl ein Verzeichnisname ist, ist der Rückgabewert nonzero.

Wenn die aktuelle Auswahl kein Verzeichnisname ist, ist der Rückgabewert 0. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn die aktuelle Auswahl einen Verzeichnisnamen oder laufwerksbuchstaben angibt, entfernt die DlgDirSelectComboBoxEx-Funktion die eingeschlossenen eckigen Klammern (und Bindestriche für Laufwerkbuchstaben), sodass der Name oder der Buchstabe in einen neuen Pfad oder Dateinamen eingefügt werden kann. Wenn keine Auswahl vorhanden ist, ändert sich der Inhalt des Puffers, auf den lpString verweist, nicht.

Die DlgDirSelectComboBoxEx-Funktion lässt nicht zu, dass mehr als ein Dateiname aus einem Kombinationsfeld zurückgegeben wird.

Wenn die Zeichenfolge so lang oder länger als der Puffer ist, enthält der Puffer die abgeschnittene Zeichenfolge mit einem endenden NULL-Zeichen.

DlgDirSelectComboBoxEx sendet CB_GETCURSEL und CB_GETLBTEXT Nachrichten an das Kombinationsfeld.

Sie können diese Funktion mit allen drei Typen von Kombinationsfeldern (CBS_SIMPLE, CBS_DROPDOWN und CBS_DROPDOWNLIST) verwenden.

Sicherheitswarnung: Eine unsachgemäße Verwendung dieser Funktion kann Probleme für Ihre Anwendung verursachen. Für instance sollte der nCount-Parameter sowohl für ANSI- als auch für Unicode-Versionen ordnungsgemäß festgelegt werden. Wenn dies nicht geschieht, kann dies zu einem Pufferüberlauf führen. Sie sollten Sicherheitsüberlegungen: Microsoft Windows-Steuerelemente lesen, bevor Sie fortfahren.

Windows 95 oder höher: DlgDirSelectComboBoxExW wird von Microsoft Layer for Unicode (MSLU) unterstützt. Um dies zu verwenden, müssen Sie Ihrer Anwendung bestimmte Dateien hinzufügen, wie in Microsoft Layer for Unicode auf Windows Me/98/95-Systemen beschrieben.

Hinweis

Der winuser.h-Header definiert DlgDirSelectComboBoxEx als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll

Weitere Informationen

CB_GETCURSEL

CB_GETLBTEXT

DlgDirListComboBox

Referenz