CM_Get_Device_ID_Size (cfgmgr32.h)

  • Artikel

Fungsi CM_Get_Device_ID_Size mengambil ukuran buffer yang diperlukan untuk menahan ID instans perangkat untuk instans perangkat di komputer lokal.

Catatan

Di Windows Vista dan versi Windows yang lebih baru, model properti perangkat terpadu menggunakan kunci propertiDEVPKEY_Device_InstanceId untuk mewakili pengidentifikasi instans perangkat. Lihat Mengambil Pengidentifikasi Instans Perangkat untuk detailnya.

Sintaks

CMAPI CONFIGRET CM_Get_Device_ID_Size(
  [out] PULONG  pulLen,
  [in]  DEVINST dnDevInst,
  [in]  ULONG   ulFlags
);

Parameter

[out] pulLen

Menerima nilai yang mewakili ukuran buffer yang diperlukan, dalam karakter.

[in] dnDevInst

Handel instans perangkat yang disediakan penelepon yang terikat ke komputer lokal.

[in] ulFlags

Tidak digunakan, harus nol.

Menampilkan nilai

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

Fungsi CM_Get_Device_ID_Size harus dipanggil untuk menentukan ukuran buffer yang diperlukan oleh CM_Get_Device_ID.

Nilai ukuran yang disediakan di lokasi yang diacu oleh pulLen kurang dari MAX_DEVICE_ID_LEN, dan tidak menyertakan string pengidentifikasi yang mengakhiri NULL. Jika instans perangkat yang ditentukan tidak ada, fungsi memasok nilai ukuran nol.

Untuk informasi tentang ID instans perangkat, lihat String Identifikasi Perangkat.

Untuk informasi tentang menggunakan handel instans perangkat yang terikat ke komputer lokal, lihat CM_Get_Child.

Persyaratan

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

Lihat juga

CM_Get_Child

CM_Get_Device_ID

CM_Get_Device_ID_Size_Ex