CM_Get_HW_Prof_FlagsA (cfgmgr32.h)
[Dimulai dengan Windows 8 dan Windows Server 2012, fungsi ini tidak digunakan lagi dan tidak boleh digunakan.]
Fungsi CM_Get_HW_Prof_Flags mengambil bendera konfigurasi khusus profil perangkat keras untuk instans perangkat pada komputer lokal.
Sintaks
CMAPI CONFIGRET CM_Get_HW_Prof_FlagsA(
[in] DEVINSTID_A pDeviceID,
[in] ULONG ulHardwareProfile,
[out] PULONG pulValue,
[in] ULONG ulFlags
);
Parameter
[in] pDeviceID
Penunjuk ke string yang dihentikan NULL yang berisi ID instans perangkat perangkat untuk mengambil bendera konfigurasi khusus profil perangkat keras.
[in] ulHardwareProfile
Variabel jenis ULONG yang menentukan pengidentifikasi profil perangkat keras untuk mengambil bendera konfigurasi. Jika parameter ini nol, fungsi ini mengambil bendera konfigurasi untuk profil perangkat keras saat ini.
[out] pulValue
Penunjuk ke variabel yang disediakan penelepon dari jenis ULONG yang menerima nol atau bitwise ATAU dari bendera konfigurasi berikut yang ditentukan dalam Regstr.h:
CSCONFIGFLAG_BITS
Bitwise OR dari bendera CSCONFIGFLAG_Xxx lainnya.
CSCONFIGFLAG_DISABLE
Instans perangkat dinonaktifkan di profil perangkat keras yang ditentukan.
CSCONFIGFLAG_DO_NOT_CREATE
Profil perangkat keras tidak mendukung instans perangkat yang ditentukan.
CSCONFIGFLAG_DO_NOT_START
Perangkat tidak dapat dimulai di profil piranti keras yang ditentukan.
[in] ulFlags
Dicadangkan untuk penggunaan internal. Harus diatur ke nol.
Menampilkan nilai
Jika operasi berhasil, CM_Get_HW_Prof_Flags mengembalikan CR_SUCCESS. Jika tidak, fungsi mengembalikan salah satu kode kesalahan CR_Xxx yang ditentukan dalam Cfgmgr32.h.
Keterangan
Untuk mengambil daftar ID profil perangkat keras yang saat ini ditentukan pada komputer lokal, panggil SetupDiGetHwProfileList.
Untuk mengambil bendera konfigurasi untuk instans perangkat pada komputer jarak jauh, panggil CM_Get_HW_Prof_Flags_Ex.
Catatan
Header cfgmgr32.h mendefinisikan CM_Get_HW_Prof_Flags sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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 | Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru. |
| Target Platform | Desktop |
| Header | cfgmgr32.h (termasuk Cfgmgr32.h) |
| Pustaka | Cfgmgr32.lib |