SetupDiClassNameFromGuidExA (setupapi.h)

Fungsi SetupDiClassNameFromGuidEx mengambil nama kelas yang terkait dengan GUID kelas. Kelas dapat diinstal pada komputer lokal atau jarak jauh.

Sintaksis

WINSETUPAPI BOOL SetupDiClassNameFromGuidExA(
  [in]            const GUID *ClassGuid,
  [out]           PSTR       ClassName,
  [in]            DWORD      ClassNameSize,
  [out, optional] PDWORD     RequiredSize,
  [in, optional]  PCSTR      MachineName,
                  PVOID      Reserved
);

Parameter

[in] ClassGuid

GUID kelas nama kelas yang akan diambil.

[out] ClassName

Penunjuk ke buffer string yang menerima nama kelas yang dihentikan NULL untuk GUID yang ditentukan.

[in] ClassNameSize

Ukuran, dalam karakter, dari className buffer.

[out, optional] RequiredSize

Jumlah karakter yang diperlukan untuk menyimpan nama kelas (termasuk penghentian null). RequiredSize selalu kurang dari MAX_CLASS_NAME_LEN.

[in, optional] MachineName

Penunjuk ke string yang dihentikan NULL yang berisi nama sistem jarak jauh tempat kelas diinstal. Parameter ini bersifat opsional dan dapat NULL. Jika MachineName null, nama sistem lokal digunakan.

Hati

Menggunakan fungsi ini untuk mengakses komputer jarak jauh tidak didukung dimulai dengan Windows 8 dan Windows Server 2012, karena fungsionalitas ini telah dihapus.

Reserved

Harus null.

Mengembalikan nilai

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

Komentar

Nota

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

SetupDiClassGuidsFromNameEx

SetupDiClassNameFromGuid