Fungsi WdfRegistryQueryULong (wdfregistry.h)
[Berlaku untuk KMDF dan UMDF]
Metode WdfRegistryQueryULong mengambil data kata panjang (REG_DWORD) yang saat ini ditetapkan ke nilai registri tertentu dan menyalin data ke lokasi tertentu.
Sintaks
NTSTATUS WdfRegistryQueryULong(
[in] WDFKEY Key,
[in] PCUNICODE_STRING ValueName,
[out] PULONG Value
);
Parameter
[in] Key
Handel ke objek kunci registri yang mewakili kunci registri yang dibuka.
[in] ValueName
Penunjuk ke struktur UNICODE_STRING yang berisi nama untuk nilai registri.
[out] Value
Penunjuk ke lokasi yang menerima data yang ditetapkan ke nilai registri yang ditentukan ValueName .
Nilai kembali
WdfRegistryQueryULong mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode mungkin mengembalikan salah satu nilai berikut:
Menampilkan kode | Deskripsi |
---|---|
|
WdfRegistryQueryULong tidak dipanggil di IRQL = PASSIVE_LEVEL. |
|
Parameter yang tidak valid ditentukan. |
|
Memori tidak cukup untuk menyelesaikan operasi. |
|
Driver tidak membuka kunci registri dengan akses KEY_QUERY_VALUE, KEY_READ, atau KEY_ALL_ACCESS. |
|
Jenis data nilai registri yang ditentukan parameter ValueName tidak REG_DWORD. |
|
Nilai registri tidak tersedia. |
Metode ini juga dapat mengembalikan nilai NTSTATUS lainnya.
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Keterangan
Untuk informasi selengkapnya tentang objek kunci registri, lihat Menggunakan Registri di Driver WDF.
Contoh
Contoh kode berikut mengambil data yang saat ini ditetapkan ke nilai NumberOfThings .
NTSTATUS status;
ULONG value;
DECLARE_CONST_UNICODE_STRING(valueName, L"NumberOfThings");
status = WdfRegistryQueryULong(
hKey,
&valueName,
&value
);
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Versi KMDF minimum | 1,0 |
Versi UMDF minimum | 2.0 |
Header | wdfregistry.h (termasuk Wdf.h) |
Pustaka | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL | PASSIVE_LEVEL |
Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk