Fungsi SetupDiGetHwProfileList (setupapi.h)
Fungsi SetupDiGetHwProfileList mengambil daftar semua ID profil perangkat keras yang saat ini ditentukan.
Sintaks
WINSETUPAPI BOOL SetupDiGetHwProfileList(
[out] PDWORD HwProfileList,
[in] DWORD HwProfileListSize,
[out] PDWORD RequiredSize,
[out, optional] PDWORD CurrentlyActiveIndex
);
Parameter
[out] HwProfileList
Penunjuk ke array untuk menerima daftar ID profil perangkat keras yang saat ini ditentukan.
[in] HwProfileListSize
Jumlah DWORD dalam buffer HwProfileList .
[out] RequiredSize
Pointer ke variabel jenis DWORD yang menerima jumlah profil perangkat keras yang saat ini ditentukan. Jika angka lebih besar dari HwProfileListSize, daftar dipotok agar sesuai dengan ukuran array. Nilai yang dikembalikan dalam RequiredSize menunjukkan ukuran array yang diperlukan untuk menyimpan seluruh daftar profil perangkat keras. Dalam hal ini, fungsi gagal dan panggilan ke GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER.
[out, optional] CurrentlyActiveIndex
Penunjuk ke variabel jenis DWORD yang menerima indeks profil perangkat keras yang saat ini aktif dalam daftar profil perangkat keras yang diambil. Parameter ini bersifat opsional dan dapat berupa NULL.
Nilai kembali
Fungsi mengembalikan TRUE jika berhasil. Jika tidak, ia mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan melakukan panggilan ke GetLastError.
Keterangan
Panggil SetupDiGetHwProfileListEx untuk mengambil ID profil perangkat keras untuk 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 |