Fungsi SetupDiGetINFClassW (setupapi.h)

Fungsi SetupDiGetINFClass mengembalikan kelas file INF perangkat tertentu.

Sintaksis

WINSETUPAPI BOOL SetupDiGetINFClassW(
  [in]            PCWSTR InfName,
  [out]           LPGUID ClassGuid,
  [out]           PWSTR  ClassName,
  [in]            DWORD  ClassNameSize,
  [out, optional] PDWORD RequiredSize
);

Parameter

[in] InfName

Penunjuk ke string yang dihentikan NULL yang menyediakan nama file INF perangkat. Nama ini dapat menyertakan jalur. Namun, jika hanya nama file yang ditentukan, file dicari di setiap direktori yang tercantum dalam entri DevicePath di bawah HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion subkunjung registri. Panjang maksimum dalam karakter, termasuk terminator NULL, dari nama file INF yang dihentikan NULL adalah MAX_PATH.

[out] ClassGuid

Pointer ke variabel jenis GUID yang menerima GUID kelas untuk file INF yang ditentukan. Jika file INF tidak menentukan nama kelas, fungsi mengembalikan struktur GUID_NULL. Panggil SetupDiClassGuidsFromName untuk menentukan apakah satu atau beberapa kelas dengan nama ini sudah diinstal.

[out] ClassName

Penunjuk ke buffer yang menerima string yang dihentikan NULL yang berisi nama kelas untuk file INF yang ditentukan. Jika file INF tidak menentukan nama kelas tetapi menentukan GUID, buffer ini menerima nama yang diambil dengan memanggil SetupDiClassNameFromGuid. Namun, jika SetupDiClassNameFromGuid tidak dapat mengambil nama kelas (misalnya, kelas tidak diinstal), maka akan mengembalikan string kosong.

[in] ClassNameSize

Ukuran, dalam karakter, dari buffer yang ditujukkan oleh parameter ClassName. Panjang maksimum nama kelas yang dihentikan NULL, dalam karakter, adalah MAX_CLASS_NAME_LEN.

[out, optional] RequiredSize

Penunjuk ke variabel berjenis DWORD yang menerima jumlah karakter yang diperlukan untuk menyimpan nama kelas, termasuk penghentian NULL. Penunjuk ini bersifat opsional dan dapat NULL.

Mengembalikan nilai

Fungsi mengembalikan TRUE jika berhasil. Jika tidak, ini mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.

Komentar

Jangan gunakan fungsi ini dengan file INF untuk Windows 9x atau Millennium Edition.

Nota

Header setupapi.h mendefinisikan SetupDiGetINFClass sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

Syarat	Nilai
klien minimum yang didukung	Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Platform Target	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib
set API	ext-ms-win-setupapi-classinstallers-l1-1-2 (diperkenalkan di Windows 10, versi 10.0.14393)

Lihat juga

SetupDiBuildClassInfoList

SetupDiClassGuidsFromName

SetupDiClassNameFromGuid

SetupDiGetClassDescription