SetupDiClassNameFromGuidA (setupapi.h)

Fungsi SetupDiClassNameFromGuid mengambil nama kelas yang terkait dengan GUID kelas.

Sintaksis

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

Parameter

[in] ClassGuid

Penunjuk 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 ditujukkan oleh parameter ClassName. Ukuran maksimum, dalam karakter, dari nama kelas yang dihentikan NULL adalah 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 NULL.

Mengembalikan nilai

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

Komentar

Panggil SetupDiClassNameFromGuidEx untuk mengambil nama kelas di komputer jarak jauh.

SetupDiClassNameFromGuid tidak memberlakukan pembatasan panjang nama kelas yang dapat dikembalikan. 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 nama kelas yang dihentikan NULL yang valid. Penelepon seharusnya tidak memerlukan buffer yang lebih besar dari MAX_CLASS_NAME_LEN. Untuk informasi selengkapnya tentang nama kelas, lihat deskripsi entri Kelas dari bagian Versi INF .

Nota

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

Lihat juga

SetupDiClassGuidsFromName

SetupDiClassNameFromGuidEx