Share via

GetFileNameFromBrowse-Funktion (shlobj_core.h)

  • Artikel

[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

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h (shlobj.h einschließen)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.0 oder höher)

Weitere Informationen

GetOpenFileName