SetupDiGetHwProfileListExA (setupapi.h)

Fungsi SetupDiGetHwProfileListEx mengambil daftar semua ID profil perangkat keras yang saat ini ditentukan di komputer lokal atau jarak jauh.

Sintaksis

WINSETUPAPI BOOL SetupDiGetHwProfileListExA(
  [out]           PDWORD HwProfileList,
  [in]            DWORD  HwProfileListSize,
  [out]           PDWORD RequiredSize,
  [out, optional] PDWORD CurrentlyActiveIndex,
  [in, optional]  PCSTR  MachineName,
                  PVOID  Reserved
);

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 dipotong agar sesuai dengan ukuran array. Nilai yang dikembalikan dalam RequiredSize menunjukkan ukuran array yang diperlukan untuk menyimpan seluruh daftar profil perangkat keras.

[out, optional] CurrentlyActiveIndex

Penunjuk ke variabel yang menerima indeks profil perangkat keras yang saat ini aktif dalam daftar profil perangkat keras yang diambil. Parameter ini bersifat opsional dan dapat NULL.

[in, optional] MachineName

Penunjuk ke string yang dihentikan NULL yang berisi nama sistem jarak jauh untuk mengambil daftar ID profil perangkat keras. Parameter ini bersifat opsional dan dapat NULL. Jika parameter ini NULL, daftar diambil untuk sistem lokal.

Hati

Menggunakan fungsi ini untuk mengakses komputer jarak jauh tidak didukung dimulai dengan Windows 8 dan Windows Server 2012, karena fungsionalitas ini telah dihapus.

Reserved

Harus null.

Mengembalikan nilai

Fungsi mengembalikan TRUE jika berhasil. Jika tidak, ini mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan melakukan panggilan ke GetLastError. Jika ukuran yang diperlukan lebih besar dari HwProfileListSize, SetupDiGetHwProfileListEx mengembalikan FALSE dan panggilan ke GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER.

Komentar

Nota

Header setupapi.h menentukan SetupDiGetHwProfileListEx 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	Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Platform Target	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

SetupDiGetHwProfileFriendlyNameEx