Fungsi SetupDiAskForOEMDisk (setupapi.h)
Fungsi SetupDiAskForOEMDisk menampilkan dialog yang meminta jalur disk penginstalan OEM kepada pengguna.
Sintaks
WINSETUPAPI BOOL SetupDiAskForOEMDisk(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData
);
Parameter
[in] DeviceInfoSet
Handel ke set informasi perangkat untuk komputer lokal. Set ini berisi elemen informasi perangkat yang mewakili perangkat yang sedang diinstal.
[in, optional] DeviceInfoData
Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat di DeviceInfoSet. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini ditentukan, SetupDiAskForOEMDisk mengaitkan driver dengan perangkat yang sedang diinstal. Jika parameter ini NULL, SetupDiAskForOEMDisk mengaitkan driver dengan daftar driver kelas global untuk DeviceInfoSet.
Nilai kembali
Fungsi mengembalikan TRUE jika berhasil dan bidang DriverPath dari struktur SP_DEVINSTALLPARAMS diperbarui untuk mencerminkan jalur baru. Jika pengguna membatalkan dialog, fungsi mengembalikan FALSE dan panggilan ke GetLastError mengembalikan ERROR_CANCELLED.
Keterangan
SetupDiAskForOEMDisk memungkinkan pengguna untuk menelusuri drive lokal dan jaringan untuk file penginstalan OEM. Namun, SetupDiAskForOEMDisk terutama dirancang untuk mendapatkan jalur driver OEM di komputer lokal sebelum memilih dan menginstal driver untuk perangkat di komputer tersebut.
Meskipun fungsi ini tidak akan gagal jika informasi perangkat diatur jika untuk komputer jarak jauh, hasilnya adalah penggunaan terbatas karena kumpulan informasi perangkat kemudian tidak dapat digunakan dengan permintaan penginstalan DIF_Xxx atau fungsi SetupDiXxx yang tidak mendukung operasi pada komputer jarak jauh.
Secara khusus, set informasi perangkat tidak dapat digunakan sebagai input dengan permintaan penginstalan DIF_SELECTDEVICE untuk memilih driver untuk perangkat, diikuti oleh permintaan penginstalan DIF_INSTALLDEVICE untuk menginstal perangkat di komputer jarak jauh.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru. |
| Target Platform | Desktop |
| Header | setupapi.h (termasuk Setupapi.h) |
| Pustaka | Setupapi.lib |
| DLL | Setupapi.dll |