fungsi CM_Get_Device_IDW (cfgmgr32.h)
Fungsi CM_Get_Device_ID mengambil ID instans perangkat untuk instans perangkat tertentu pada 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_IDW(
[in] DEVINST dnDevInst,
[out] PWSTR Buffer,
[in] ULONG BufferLen,
[in] ULONG ulFlags
);
Parameter
[in] dnDevInst
Handel instans perangkat yang disediakan penelepon yang terikat ke komputer lokal.
[out] Buffer
Alamat buffer untuk menerima string ID instans perangkat. Ukuran buffer yang diperlukan dapat diperoleh dengan memanggil CM_Get_Device_ID_Size, lalu menambah nilai yang diterima untuk memungkinkan ruang bagi NULL yang mengakhiri string.
[in] BufferLen
Panjang yang disediakan pemanggil, dalam karakter, dari buffer yang ditentukan oleh Buffer.
[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 ini menambahkan terminator NULL ke string ID instans perangkat yang disediakan, kecuali buffer terlalu kecil untuk menahan string. Dalam hal ini, fungsi memasok string pengidentifikasi sebanyak yang akan masuk ke dalam buffer, dan kemudian mengembalikan CR_BUFFER_SMALL.
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 |