CM_Get_Device_ID_Size (cfgmgr32.h)
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 |