CM_Get_Device_Interface_List_SizeW (cfgmgr32.h)

Artikel
02/26/2024

Fungsi CM_Get_Device_Interface_List_Size mengambil ukuran buffer yang harus diteruskan ke fungsi CM_Get_Device_Interface_List .

Sintaks

CMAPI CONFIGRET CM_Get_Device_Interface_List_SizeW(
  [out]          PULONG      pulLen,
  [in]           LPGUID      InterfaceClassGuid,
  [in, optional] DEVINSTID_W pDeviceID,
  [in]           ULONG       ulFlags
);

Parameter

[out] pulLen

Penunjuk yang disediakan penelepon ke lokasi yang menerima panjang yang diperlukan, dalam karakter, dari buffer untuk menahan beberapa string Unicode yang akan dikembalikan oleh CM_Get_Device_Interface_List.

[in] InterfaceClassGuid

Menyediakan GUID yang mengidentifikasi kelas antarmuka perangkat.

[in, optional] pDeviceID

Penunjuk yang disediakan penelepon ke string yang dihentikan NULL yang mewakili ID instans perangkat. Jika ditentukan, fungsi mengambil panjang nama tautan simbolis untuk antarmuka perangkat yang didukung oleh perangkat, untuk kelas yang ditentukan. Jika nilai ini NULL, atau jika menunjuk ke string panjang nol, fungsi mengambil panjang nama tautan simbolis untuk semua antarmuka yang termasuk dalam kelas yang ditentukan.

[in] ulFlags

Berisi salah satu bendera yang disediakan penelepon berikut:

Nilai	Makna
CM_GET_DEVICE_INTERFACE_LIST_ALL_DEVICES	Fungsi ini menyediakan ukuran daftar yang berisi antarmuka perangkat yang terkait dengan semua perangkat yang cocok dengan GUID dan ID instans perangkat yang ditentukan, jika ada.
CM_GET_DEVICE_INTERFACE_LIST_PRESENT	Fungsi ini menyediakan ukuran daftar yang berisi antarmuka perangkat yang terkait dengan perangkat yang saat ini aktif, dan yang cocok dengan GUID dan ID instans perangkat yang ditentukan, jika ada.

Menampilkan nilai

Jika operasi berhasil, fungsi akan mengembalikan CR_SUCCESS. Jika tidak, ia mengembalikan salah satu kode kesalahan dengan awalan CR_ seperti yang didefinisikan dalam Cfgmgr32.h.

Keterangan

Catatan

Header cfgmgr32.h mendefinisikan CM_Get_Device_Interface_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_Interface_List