Fungsi SetupPromptForDiskW (setupapi.h)

[Fungsi ini tersedia untuk digunakan dalam sistem operasi yang ditunjukkan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. SetupAPI tidak boleh lagi digunakan untuk menginstal aplikasi. Sebagai gantinya, gunakan Pemasang Windows untuk mengembangkan penginstal aplikasi. PenyetelanAPI terus digunakan untuk menginstal pengandar perangkat.]

Fungsi SetupPromptForDisk menampilkan kotak dialog yang meminta disk kepada pengguna.

Sintaks

WINSETUPAPI UINT SetupPromptForDiskW(
  [in]      HWND   hwndParent,
  [in]      PCWSTR DialogTitle,
  [in]      PCWSTR DiskName,
  [in]      PCWSTR PathToSource,
  [in]      PCWSTR FileSought,
  [in]      PCWSTR TagFile,
  [in]      DWORD  DiskPromptStyle,
  [in, out] PWSTR  PathBuffer,
  [in]      DWORD  PathBufferSize,
  [in, out] PDWORD PathRequiredSize
);

Parameter

[in] hwndParent

Tangani ke jendela induk untuk kotak dialog ini.

[in] DialogTitle

Penunjuk opsional ke string yang dihentikan null yang menentukan judul dialog. Jika parameter ini NULL, default ""%s--Files Needed"" (dilokalkan) digunakan. "%s" diganti dengan teks yang diambil dari jendela induk. Jika tidak ada teks yang diambil dari jendela induk, judulnya adalah "File Diperlukan".

[in] DiskName

Penunjuk opsional ke string yang dihentikan null yang menentukan nama disk yang akan dimasukkan. Jika parameter ini NULL, default "(Tidak Diketahui)" (dilokalkan) digunakan.

[in] PathToSource

Penunjuk opsional ke string yang dihentikan null yang menentukan bagian jalur dari lokasi file yang diharapkan, misalnya, F:\x86. Jika tidak ditentukan, jalur tempat SetupPromptForDisk baru-baru ini menemukan file digunakan. Jika daftar tersebut kosong, default sistem akan digunakan.

[in] FileSought

Penunjuk ke string yang dihentikan null yang menentukan nama file yang diperlukan (hanya bagian nama file). Nama file ditampilkan jika pengguna mengklik tombol Telusuri . Rutinitas ini mencari file menggunakan nama formulir terkompresinya; oleh karena itu, Anda dapat meneruskan cmd.exe dan tidak khawatir bahwa file benar-benar ada sebagai cmd.ex_ di media sumber.

[in] TagFile

Penunjuk opsional ke string yang dihentikan null yang menentukan file tag (hanya bagian nama file) yang mengidentifikasi keberadaan volume media tertentu yang dapat dilepas. Jika jalur yang saat ini dipilih akan menempatkan file pada media yang dapat dilepas dan file tag ditentukan, SetupPromptForDisk mencari file tag di akar drive untuk menentukan apakah akan melanjutkan.

Misalnya, jika PathToSource adalah A:\x86, tagfile adalah disk1.tag, dan jenis pengguna B:\x86 ke dalam kontrol edit kotak dialog prompt, rutinitas mencari B:\disk1.tag untuk menentukan apakah akan melanjutkan. Jika file tag tidak ditemukan, fungsi mencari tagfile menggunakan PathToSource.

Jika file tag tidak ditentukan, media yang dapat dilepas berfungsi seperti media yang tidak dapat dilepas dan FileSought dicari sebelum melanjutkan.

[in] DiskPromptStyle

Menentukan perilaku kotak dialog. Parameter ini bisa menjadi kombinasi dari bendera berikut.

IDF_CHECKFIRST

Periksa file/disk sebelum menampilkan kotak dialog perintah, dan, jika ada, segera kembalikan DPROMPT_SUCCESS.

IDF_NOBEEP

Cegah kotak dialog berbunyi untuk mendapatkan perhatian pengguna saat pertama kali muncul.

IDF_NOBROWSE

Jangan tampilkan opsi telusuri.

IDF_NOCOMPRESSED

Jangan periksa versi terkompresi dari file sumber.

IDF_NODETAILS

Jangan tampilkan informasi detail.

IDF_NOFOREGROUND

Cegah kotak dialog menjadi jendela latar depan.

IDF_NOSKIP

Jangan tampilkan opsi lewati.

IDF_OEMDISK

Meminta disk yang disediakan oleh produsen perangkat keras.

IDF_WARNIFSKIP

Peringatkan pengguna yang melewatkan file dapat memengaruhi penginstalan.

[in, out] PathBuffer

Penunjuk opsional ke buffer yang, saat kembali, menerima jalur (tanpa nama file) dari lokasi yang ditentukan oleh pengguna melalui kotak dialog. Anda harus menggunakan string yang dihentikan null. String yang dihentikan null tidak boleh melebihi ukuran buffer tujuan. Anda dapat memanggil fungsi sekali untuk mendapatkan ukuran buffer yang diperlukan, mengalokasikan memori yang diperlukan, lalu memanggil fungsi untuk kedua kalinya untuk mengambil data. Dengan menggunakan teknik ini, Anda dapat menghindari kesalahan karena ukuran buffer yang tidak memadai. Lihat bagian Keterangan.

[in] PathBufferSize

Ukuran buffer yang diacu oleh PathBuffer, dalam karakter. Setidaknya harus MAX_PATH lama. Ini termasuk terminator null .

[in, out] PathRequiredSize

Penunjuk opsional ke variabel yang menerima ukuran yang diperlukan untuk PathBuffer, dalam karakter. Ini termasuk terminator null .

Nilai kembali

Fungsi mengembalikan salah satu nilai berikut.

Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Jika fungsi ini dipanggil dengan PathBufferNULL dan PathBufferSize nol, fungsi menempatkan ukuran buffer yang diperlukan untuk menyimpan data yang ditentukan ke dalam variabel yang ditunjukkan oleh PathRequiredSize. Jika fungsi berhasil dalam hal ini, nilai yang dikembalikan adalah NO_ERROR. Jika tidak, nilai yang dikembalikan adalah salah satu nilai yang dijelaskan di bagian Nilai Hasil.

Catatan

Header setupapi.h mendefinisikan SetupPromptForDisk sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	setupapi.h
Pustaka	Setupapi.lib
DLL	Setupapi.dll

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2023-03-15