Fungsi SetupDiGetINFClassA (setupapi.h)

  • Artikel

Fungsi SetupDiGetINFClass mengembalikan kelas file INF perangkat tertentu.

Sintaks

WINSETUPAPI BOOL SetupDiGetINFClassA(
  [in]            PCSTR  InfName,
  [out]           LPGUID ClassGuid,
  [out]           PSTR   ClassName,
  [in]            DWORD  ClassNameSize,
  [out, optional] PDWORD RequiredSize
);

Parameter

[in] InfName

Penunjuk ke string yang dihentikan NULL yang memasok 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 subkuntang HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion dari registri . Panjang maksimum dalam karakter, termasuk terminator NULL, dari nama file INF yang dihentikan NULL MAX_PATH.

[out] ClassGuid

Penunjuk 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), itu mengembalikan string kosong.

[in] ClassNameSize

Ukuran, dalam karakter, dari buffer yang diacu 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 NULL yang mengakhiri. Penunjuk ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

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

Keterangan

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

Catatan

Header setupapi.h mendefinisikan SetupDiGetINFClass 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 Desktop
Header setupapi.h (termasuk Setupapi.h)
Pustaka Setupapi.lib

Lihat juga

SetupDiBuildClassInfoList

SetupDiClassGuidsFromName

SetupDiClassNameFromGuid

SetupDiGetClassDescription