SetupDiClassNameFromGuidA (setupapi.h)

Artikel
08/26/2023

Fungsi SetupDiClassNameFromGuid mengambil nama kelas yang terkait dengan GUID kelas.

Sintaks

WINSETUPAPI BOOL SetupDiClassNameFromGuidA(
  [in]            const GUID *ClassGuid,
  [out]           PSTR       ClassName,
  [in]            DWORD      ClassNameSize,
  [out, optional] PDWORD     RequiredSize
);

Parameter

[in] ClassGuid

Pointer ke GUID kelas untuk nama kelas yang akan diambil.

[out] ClassName

Penunjuk ke buffer yang menerima string yang dihentikan NULL yang berisi nama kelas yang ditentukan oleh penunjuk dalam parameter ClassGuid .

[in] ClassNameSize

Ukuran, dalam karakter, dari buffer yang diacu oleh parameter ClassName . Ukuran maksimum, dalam karakter, dari nama kelas yang dihentikan NULL MAX_CLASS_NAME_LEN. Untuk informasi selengkapnya tentang ukuran nama kelas, lihat bagian Keterangan berikut ini.

[out, optional] RequiredSize

Penunjuk ke variabel yang menerima jumlah karakter yang diperlukan untuk menyimpan nama kelas yang dihentikan NULL yang diminta. Penunjuk ini bersifat opsional dan dapat berupa NULL.

Mengembalikan nilai

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

Keterangan

Panggil SetupDiClassNameFromGuidEx untuk mengambil nama untuk kelas di komputer jarak jauh.

SetupDiClassNameFromGuid tidak memberlakukan pembatasan panjang nama kelas yang dapat dikembalikannya. Fungsi ini mengembalikan ukuran yang diperlukan untuk nama kelas yang dihentikan NULL meskipun lebih besar dari MAX_CLASS_NAME_LEN. Namun, MAX_CLASS_NAME_LEN adalah panjang maksimum dari nama kelas yang dihentikan NULL yang valid. Penelepon tidak boleh memerlukan buffer yang lebih besar dari MAX_CLASS_NAME_LEN. Untuk informasi selengkapnya tentang nama kelas, lihat deskripsi entri Kelasdari bagian Versi INF.

Catatan

Header setupapi.h mendefinisikan SetupDiClassNameFromGuid 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

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

SetupDiClassGuidsFromName

SetupDiClassNameFromGuidEx

Bagikan melalui