fungsi CM_Get_Class_Registry_PropertyW (cfgmgr32.h)

Artikel
08/22/2023

Fungsi CM_Get_Class_Registry_Property mengambil properti kelas penyiapan perangkat.

Sintaks

CMAPI CONFIGRET CM_Get_Class_Registry_PropertyW(
  [in]            LPGUID   ClassGuid,
  [in]            ULONG    ulProperty,
  [out, optional] PULONG   pulRegDataType,
  [out]           PVOID    Buffer,
  [in, out]       PULONG   pulLength,
  [in]            ULONG    ulFlags,
  [in, optional]  HMACHINE hMachine
);

Parameter

[in] ClassGuid

Penunjuk ke GUID yang mewakili kelas penyiapan perangkat untuk mengambil properti.

[in] ulProperty

Nilai jenis ULONG yang mengidentifikasi properti yang akan diambil. Nilai ini harus merupakan salah satu nilai CM_CRP_Xxx berikut yang ditentukan dalam Cfgmgr32.h:

CM_CRP_UPPERFILTERS

Mewakili daftar string jenis REG_MULTI_SZ, di mana setiap string berisi nama driver filter tingkat atas yang terdaftar untuk kelas .

CM_CRP_LOWERFILTERS

Mewakili daftar string yang diketik REG_MULTI_SZ, di mana setiap string berisi nama driver filter tingkat bawah yang terdaftar untuk kelas .

CM_CRP_SECURITY

Mewakili nilai jenis REG_BINARY yang berisi struktur SECURITY_DESCRIPTOR panjang variabel, relatif mandiri, dan SECURITY_DESCRIPTOR .

CM_CRP_SECURITY_SDS

Mewakili string jenis REG_SZ yang berisi deskriptor keamanan dalam format Bahasa Definisi Deskriptor Keamanan (SDDL ).

CM_CRP_DEVTYPE

Mewakili nilai jenis REG_DWORD yang menunjukkan jenis perangkat untuk kelas . Untuk informasi selengkapnya, lihat Menentukan Jenis Perangkat.

CM_CRP_EXCLUSIVE

Mewakili nilai jenis REG_DWORD yang menunjukkan apakah pengguna dapat memperoleh akses eksklusif ke perangkat untuk kelas ini. Nilai yang dikembalikan adalah 1 jika akses eksklusif diizinkan, atau nol sebaliknya.

CM_CRP_CHARACTERISTICS

Mewakili nilai jenis DWORD yang menunjukkan karakteristik perangkat untuk kelas . Untuk daftar bendera karakteristik, lihat parameter DeviceCharacteristics dari rutinitas IoCreateDevice .

[out, optional] pulRegDataType

Penunjuk ke variabel jenis ULONG yang menerima konstanta REG_Xxx yang mewakili jenis data properti yang diminta. Konstanta REG_Xxx didefinisikan dalam Winnt.h dan dijelaskan dalam anggota Jenis struktur KEY_VALUE_BASIC_INFORMATION . Parameter ini bersifat opsional dan dapat diatur ke NULL.

[out] Buffer

Penunjuk ke buffer yang menerima data properti yang diminta. Untuk informasi selengkapnya tentang parameter ini dan parameter ukuran buffer pulLength, lihat bagian Keterangan berikut.

[in, out] pulLength

Pointer ke variabel jenis ULONG yang nilainya, pada input, adalah ukuran, dalam byte, dari buffer yang disediakan oleh Buffer. Saat dikembalikan, CM_Get_Class_Registry_Property mengatur variabel ini ke ukuran, dalam byte, dari properti yang diminta.

[in] ulFlags

Dicadangkan untuk penggunaan internal saja. Harus diatur ke nol.

[in, optional] hMachine

Handel ke komputer jarak jauh untuk mengambil properti kelas perangkat yang ditentukan. Parameter ini bersifat opsional, dan, jika diatur ke NULL, properti diambil dari komputer lokal.

Nilai kembali

Jika operasi berhasil, CM_Get_Class_Registry_Property mengembalikan CR_SUCCESS. Jika tidak, fungsi mengembalikan salah satu kode status CR_Xxx lainnya yang ditentukan dalam Cfgmgr32.h.

Keterangan

Untuk menentukan ukuran, dalam byte, properti sebelum mencoba mengambil properti, pertama-tama panggil CM_Get_Class_Registry_Property, menyediakan pointer BufferNULL dan nilai pulLength nol. Menanggapi panggilan seperti itu, fungsi tidak mengambil properti , tetapi mengatur pulLength ke ukuran properti yang diminta dan mengembalikan CR_BUFFER_SMALL. Setelah mendapatkan ukuran properti, panggil CM_Get_Class_Registry_Property lagi, menyediakan penunjuk Buffer ke buffer untuk menerima data properti dan menyediakan ukuran properti di *pulLength.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Target Platform	Universal
Header	cfgmgr32.h (termasuk Cfgmgr32.h)
Pustaka	Cfgmgr32.lib