fungsi CM_Get_Device_Interface_Property_Keys_ExW (cfgmgr32.h)

Artikel
08/22/2023

[Dimulai dengan Windows 8 dan Windows Server 2012, fungsi ini tidak digunakan lagi. Silakan gunakan CM_Get_Device_Interface_Property_Keys sebagai gantinya.]

Fungsi CM_Get_Device_Interface_Property_Keys_ExW mengambil array kunci properti perangkat yang mewakili properti perangkat yang diatur untuk antarmuka perangkat.

Sintaks

CMAPI CONFIGRET CM_Get_Device_Interface_Property_Keys_ExW(
  [in]            LPCWSTR    pszDeviceInterface,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags,
  [in, optional]  HMACHINE   hMachine
);

Parameter

[in] pszDeviceInterface

Penunjuk ke string yang mengidentifikasi instans antarmuka perangkat untuk mengambil kunci properti.

[out, optional] PropertyKeyArray

Penunjuk ke buffer yang menerima array nilai yang diketik DEVPROPKEY, di mana setiap nilai adalah kunci properti perangkat yang mewakili properti perangkat yang diatur untuk antarmuka 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_Device_Interface_Property_Keys_ExW mengembalikan jumlah kunci, dalam *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, ia mengembalikan salah satu kode kesalahan awalan CR_ yang ditentukan dalam Cfgmgr32.h.

Keterangan

CM_Get_Device_Interface_Property_Keys_ExW 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

Lihat juga

CM_Connect_Machine

SetupDiGetDeviceInterfacePropertyKeys

Bagikan melalui