fungsi CM_Get_Device_ID_List_SizeA (cfgmgr32.h)

  • Artikel

Fungsi CM_Get_Device_ID_List_Size mengambil ukuran buffer yang diperlukan untuk menyimpan daftar ID instans perangkat untuk instans perangkat komputer lokal.

Sintaks

CMAPI CONFIGRET CM_Get_Device_ID_List_SizeA(
  [out]          PULONG pulLen,
  [in, optional] PCSTR  pszFilter,
  [in]           ULONG  ulFlags
);

Parameter

[out] pulLen

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

[in, optional] pszFilter

Penunjuk yang disediakan penelepon ke string karakter yang menentukan subset pengidentifikasi instans perangkat komputer, atau NULL. Lihat deskripsi ulFlags berikut.

[in] ulFlags

Salah satu bendera bit opsional yang disediakan penelepon yang menentukan filter pencarian. Jika tidak ada bendera yang ditentukan, fungsi memasok ukuran buffer yang diperlukan untuk menahan semua pengidentifikasi instans untuk semua instans perangkat. Untuk daftar bendera bit, lihat deskripsi ulFlags untuk CM_Get_Device_ID_List.

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_List_Size harus dipanggil untuk menentukan ukuran buffer yang diperlukan oleh CM_Get_Device_ID_List.

Nilai ukuran yang disediakan di lokasi yang ditunjukkan oleh pulLen dijamin mewakili ukuran buffer yang cukup besar untuk menahan semua string pengidentifikasi instans perangkat dan mengakhiri NULL. Nilai yang disediakan mungkin benar-benar mewakili ukuran buffer yang lebih besar dari yang diperlukan, jadi jangan asumsikan nilai mewakili panjang sebenarnya dari string karakter yang akan disediakan CM_Get_Device_ID_List .

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

Catatan

Header cfgmgr32.h mendefinisikan CM_Get_Device_ID_List_Size sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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
DLL CfgMgr32.dll

Lihat juga

CM_Get_Device_ID_List_Size_Ex