fungsi CM_Get_DevNode_Property_Keys_Ex (cfgmgr32.h)

  • Artikel

[Dimulai dengan Windows 8 dan Windows Server 2012, fungsi ini tidak digunakan lagi. Gunakan CM_Get_DevNode_Property_Keys sebagai gantinya.]

Fungsi CM_Get_DevNode_Property_Keys_Ex mengambil array kunci properti perangkat yang mewakili properti perangkat yang diatur untuk instans perangkat.

Sintaks

CMAPI CONFIGRET CM_Get_DevNode_Property_Keys_Ex(
  [in]            DEVINST    dnDevInst,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags,
  [in, optional]  HMACHINE   hMachine
);

Parameter

[in] dnDevInst

Handel instans perangkat yang terikat ke komputer lokal.

[out, optional] PropertyKeyArray

Pointer ke buffer yang menerima array nilai yang diketik DEVPROPKEY, di mana setiap nilai adalah kunci properti perangkat yang mewakili properti perangkat yang diatur untuk instans perangkat. Penunjuk bersifat opsional dan dapat berupa NULL.

[in, out] PropertyKeyCount

Ukurannya, dalam unit yang diketik DEVPROPKEY, dari buffer PropertyKeyArray . Jika PropertyKeyArray diatur ke NULL, *PropertyKeyCount harus diatur ke nol. Sebagai output, Jika PropertyKeyArray tidak cukup besar untuk menyimpan semua data kunci properti, CM_Get_DevNode_Property_Keys_Ex mengembalikan jumlah kunci di *PropertyKeyCount.

[in] ulFlags

Dicadangkan. Harus diatur ke nol.

[in, optional] hMachine

Handel mesin yang disediakan penelepon, diperoleh dari panggilan sebelumnya ke CM_Connect_Machine.

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

Nilai kembali

Jika operasi berhasil, fungsi akan mengembalikan CR_SUCCESS. Jika tidak, kode kesalahan mengembalikan salah satu kode kesalahan awalan CR_ yang ditentukan dalam Cfgmgr32.h.

Keterangan

CM_Get_DevNode_Property_Keys_Ex adalah bagian dari Model Properti Perangkat Terpadu.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Microsoft Windows 10 dan versi Windows yang lebih baru.
Target Platform Desktop
Header cfgmgr32.h (termasuk Cfgmgr32.h)
Pustaka Cfgmgr32.lib; OneCoreUAP.lib di Windows 10
DLL CfgMgr32.dll

Lihat juga

CM_Connect_Machine

SetupDiGetDevicePropertyKeys