CM_Get_HW_Prof_FlagsA (cfgmgr32.h)

  • Artikel

[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

Lihat juga

CM_Get_HW_Prof_Flags_Ex

SetupDiGetHwProfileFriendlyName

SetupDiGetHwProfileList