SetupDiClassNameFromGuidExW (setupapi.h)

Artikel
03/04/2024

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

Sintaks

WINSETUPAPI BOOL SetupDiClassNameFromGuidExW(
  [in]            const GUID *ClassGuid,
  [out]           PWSTR      ClassName,
  [in]            DWORD      ClassNameSize,
  [out, optional] PDWORD     RequiredSize,
  [in, optional]  PCWSTR     MachineName,
                  PVOID      Reserved
);

Parameter

[in] ClassGuid

GUID kelas dari 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 buffer ClassName .

[out, optional] RequiredSize

Jumlah karakter yang diperlukan untuk menyimpan nama kelas (termasuk yang mengakhiri 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 berupa NULL. Jika MachineNameNULL, nama sistem lokal 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.

Mengembalikan nilai

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

Keterangan

Catatan

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

SetupDiClassGuidsFromNameEx

SetupDiClassNameFromGuid

Bagikan melalui