GetFileNameFromBrowse-Funktion (shlobj.h)
[Diese Funktion ist über Windows XP Service Pack 2 (SP2) und Windows Server 2003 verfügbar. In nachfolgenden Versionen von Windows ist sie möglicherweise geändert oder nicht verfügbar.]
Erstellt ein Dialogfeld Öffnen , damit der Benutzer das Laufwerk, das Verzeichnis und den Namen einer zu öffnenden Datei angeben kann.
Syntax
BOOL GetFileNameFromBrowse(
[in, optional] HWND hwnd,
[in, out] PWSTR pszFilePath,
UINT cchFilePath,
[in, optional] PCWSTR pszWorkingDir,
[in] PCWSTR pszDefExt,
[in, optional] PCWSTR pszFilters,
[in, optional] PCWSTR pszTitle
);
Parameter
[in, optional] hwnd
Typ: HWND
Ein Handle für das Fenster, das das Dialogfeld besitzt. Bei diesem Member kann es sich um ein beliebiges gültiges Fensterhandle handeln, oder es kann NULL sein, wenn das Dialogfeld keinen Besitzer hat.
[in, out] pszFilePath
Typ: PWSTR
Eine Unicode-Zeichenfolge mit Null-Termin, die einen Dateinamen enthält, der zum Initialisieren des Bearbeitungssteuerelements für Dateinamen verwendet wird. Diese Zeichenfolge entspricht dem lpstrFile-Element der OPENFILENAME-Struktur und wird genauso verwendet.
cchFilePath
Typ: UINT
Die Anzahl der Zeichen in pszFilePath, einschließlich des abschließenden NULL-Zeichens.
[in, optional] pszWorkingDir
Typ: PCWSTR
Der vollqualifizierte Dateipfad des Anfangsverzeichnisses. Diese Zeichenfolge entspricht dem lpstrInitialDir-Element der OPENFILENAME-Struktur und wird genauso verwendet.
[in] pszDefExt
Typ: PCWSTR
Eine unicode-Zeichenfolge mit Null-Termin, die die Standarddateierweiterung enthält. Diese Erweiterung wird zu pszFilePath hinzugefügt, wenn der Benutzer keine Erweiterung angibt. Die Zeichenfolge darf keine "."-Zeichen enthalten. Wenn diese Zeichenfolge NULL ist und der Benutzer keine Erweiterung eingeben kann, wird keine Erweiterung angefügt.
[in, optional] pszFilters
Typ: PCWSTR
Eine unicode-Zeichenfolge mit Null-Termin, die den Filter definiert. Diese Zeichenfolge entspricht dem lpstrFilter-Element der OPENFILENAME-Struktur und wird genauso verwendet.
[in, optional] pszTitle
Typ: PCWSTR
Eine Unicode-Zeichenfolge mit Null-Termin, die in der Titelleiste des Dialogfelds platziert wird. Wenn dieser Wert NULL ist, verwendet das System den Standardtitel.
Rückgabewert
Typ: BOOL
Wenn der Benutzer einen Dateinamen angibt und auf OK klickt, ist der Rückgabewert TRUE. Der Puffer, auf den pszFilePath verweist, enthält den vollständigen Pfad und Dateinamen, den der Benutzer angibt. Wenn der Benutzer das Dialogfeld Öffnen abbricht oder schließt oder ein Fehler auftritt, ist der Rückgabewert FALSE.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shlobj.h (shlobj.h einschließen) |
| Bibliothek | Shell32.lib |
| DLL | Shell32.dll (Version 5.0 oder höher) |