Fungsi GetFileNameFromBrowse (shlobj.h)

[Fungsi ini tersedia melalui Windows XP Service Pack 2 (SP2) dan Windows Server 2003. Ini mungkin diubah atau tidak tersedia dalam versi Windows berikutnya.]

Membuat kotak dialog Buka sehingga pengguna dapat menentukan drive, direktori, dan nama file yang akan dibuka.

Sintaks

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

Jenis: HWND

Handel ke jendela yang memiliki kotak dialog. Anggota ini bisa menjadi handel jendela yang valid, atau bisa NULL jika kotak dialog tidak memiliki pemilik.

[in, out] pszFilePath

Jenis: PWSTR

String Unicode yang dihentikan null yang berisi nama file yang digunakan untuk menginisialisasi kontrol edit Nama File. String ini sesuai dengan anggota lpstrFile struktur OPENFILENAME dan digunakan dengan cara yang sama persis.

cchFilePath

Jenis: UINT

Jumlah karakter dalam pszFilePath, termasuk karakter null yang mengakhiri.

[in, optional] pszWorkingDir

Jenis: PCWSTR

Jalur file yang sepenuhnya memenuhi syarat dari direktori awal. String ini sesuai dengan anggota lpstrInitialDir struktur OPENFILENAME dan digunakan dengan cara yang sama persis.

[in] pszDefExt

Jenis: PCWSTR

String Unicode yang dihentikan null yang berisi ekstensi nama file default. Ekstensi ini ditambahkan ke pszFilePath jika pengguna tidak menentukan ekstensi. String tidak boleh berisi karakter '.' apa pun. Jika string ini NULL dan pengguna gagal mengetik ekstensi, tidak ada ekstensi yang ditambahkan.

[in, optional] pszFilters

Jenis: PCWSTR

Untai (karakter) Unicode yang dihentikan null yang menentukan filter. String ini sesuai dengan anggota lpstrFilter struktur OPENFILENAME dan digunakan dengan cara yang sama persis.

[in, optional] pszTitle

Jenis: PCWSTR

String Unicode yang dihentikan null yang ditempatkan di bilah judul kotak dialog. Jika nilai ini NULL, sistem akan menggunakan judul default.

Nilai kembali

Jenis: BOOL

Jika pengguna menentukan nama file dan mengklik OK, nilai yang dikembalikan adalah TRUE. Buffer yang dituju pszFilePath berisi jalur lengkap dan nama file yang ditentukan pengguna. Jika pengguna membatalkan atau menutup kotak dialog Buka atau terjadi kesalahan, nilai yang dikembalikan adalah FALSE.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj.h (termasuk Shlobj.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 5.0 atau yang lebih baru)

Lihat juga

GetOpenFileName