Bagikan melalui

Fungsi DragQueryFileA (shellapi.h)

  • Artikel

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

Sintaks

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

Parameter

[in] hDrop

Jenis: HDROP

Pengidentifikasi struktur yang berisi nama file dari file yang dijatuhkan.

[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 ditujukkan oleh parameter lpszFile .

[out] lpszFile

Jenis: LPTSTR

Alamat buffer yang menerima nama file dari 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

Ukuran, dalam karakter, dari buffer lpszFile .

Mengembalikan nilai

Jenis: UINT

Nilai bukan nol menunjukkan panggilan yang berhasil.

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

Jika nilai indeks 0xFFFFFFFF, nilai yang dikembalikan adalah hitungan file yang dihilangkan. 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 adalah NULL, nilai yang dikembalikan adalah ukuran yang diperlukan, dalam karakter, dari buffer, tidak termasuk karakter null yang mengakhiri.

Keterangan

Catatan

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

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform 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 dalam Windows 10, versi 10.0.10240)

Lihat juga

DragQueryPoint