Fungsi SetupDiClassGuidsFromNameExA (setupapi.h)

Artikel
03/04/2024

Fungsi SetupDiClassGuidsFromNameEx mengambil GUID yang terkait dengan nama kelas yang ditentukan. Daftar yang dihasilkan ini berisi kelas yang saat ini terinstal pada komputer lokal atau jarak jauh.

Sintaks

WINSETUPAPI BOOL SetupDiClassGuidsFromNameExA(
  [in]           PCSTR  ClassName,
  [out]          LPGUID ClassGuidList,
  [in]           DWORD  ClassGuidListSize,
  [out]          PDWORD RequiredSize,
  [in, optional] PCSTR  MachineName,
                 PVOID  Reserved
);

Parameter

[in] ClassName

Nama kelas untuk mengambil GUID kelas.

[out] ClassGuidList

Penunjuk ke array untuk menerima daftar GUID yang terkait dengan nama kelas yang ditentukan.

[in] ClassGuidListSize

Jumlah GUID dalam array ClassGuidList .

[out] RequiredSize

Pointer ke variabel yang menerima jumlah GUID yang terkait dengan nama kelas. Jika angka ini lebih besar dari ukuran buffer ClassGuidList , angka menunjukkan seberapa besar array harus untuk menyimpan semua GUID.

[in, optional] MachineName

Penunjuk ke string yang dihentikan NULL yang berisi nama sistem jarak jauh untuk mengambil GUID. Parameter ini bersifat opsional dan dapat berupa NULL. Jika MachineNameADALAH NULL, nama sistem lokal akan digunakan.

Perhatian

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

Reserved

Harus NULL.

Nilai kembali

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

Keterangan

Nama kelas tidak dijamin unik; hanya GUID yang unik. Oleh karena itu, satu nama kelas dapat mengembalikan lebih dari satu GUID.

Catatan

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

SetupDiClassGuidsFromName

SetupDiClassNameFromGuidEx

Bagikan melalui