Fungsi DragQueryFileA (shellapi.h)

Mengambil nama file yang dihilangkan yang dihasilkan dari operasi seret dan letakkan yang berhasil.

Sintaksis

UINT DragQueryFileA(
  [in]  HDROP hDrop,
  [in]  UINT  iFile,
  [out] LPSTR lpszFile,
        UINT  cch
);

Parameter

[in] hDrop

Jenis: HDROP

Pengidentifikasi struktur yang berisi nama file file yang dihilangkan.

[in] iFile

Jenis: UINT

Indeks file yang akan dikueri. Jika nilai parameter ini 0xFFFFFFFF, DragQueryFile mengembalikan hitungan file yang dihilangkan. Jika nilai parameter ini antara nol dan jumlah total file yang dihilangkan, DragQueryFile menyalin nama file dengan nilai yang sesuai dengan buffer yang ditunjukkan oleh parameter lpszFile.

[out] lpszFile

Jenis: LPTSTR

Alamat buffer yang menerima nama file file yang dijatuhkan saat fungsi kembali. Nama file ini adalah string yang dihentikan null. Jika parameter ini null, DragQueryFile mengembalikan ukuran yang diperlukan, dalam karakter, dari buffer ini.

cch

Jenis: UINT

Ukurannya, dalam karakter, dari buffer lpszFile.

Mengembalikan nilai

Jenis: UINT

Nilai bukan nol menunjukkan panggilan yang berhasil.

Ketika fungsi menyalin nama file ke buffer, nilai yang dikembalikan adalah hitungan karakter yang disalin, tidak termasuk karakter null yang mengakhiri.

Jika nilai indeks 0xFFFFFFFF, nilai yang dikembalikan adalah hitungan file yang dijatuhkan. Perhatikan bahwa variabel indeks itu sendiri mengembalikan tidak berubah, dan karenanya tetap 0xFFFFFFFF.

Jika nilai indeks antara nol dan jumlah total file yang dijatuhkan, dan alamat buffer lpszFile NULL, nilai yang dikembalikan adalah ukuran yang diperlukan, dalam karakter, dari buffer, tidak termasuk karakter null yang mengakhiri.

Komentar

Nota

Header shellapi.h mendefinisikan DragQueryFile sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	shellapi.h
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 4.0 atau yang lebih baru)
set API	ext-ms-win-shell-shell32-l1-2-1 (diperkenalkan di Windows 10, versi 10.0.10240)

Lihat juga

DragQueryPoint