Fungsi RtlQueryRegistryValueWithFallback (ntddk.h)
Mengambil entri nilai untuk kunci registri dengan menggunakan, handel utama; jika tidak ditemukan, menggunakan handel fallback.
Sintaks
NTSYSAPI NTSTATUS RtlQueryRegistryValueWithFallback(
[in] HANDLE PrimaryHandle,
[in] HANDLE FallbackHandle,
[in] PUNICODE_STRING ValueName,
[in] ULONG ValueLength,
[Out] PULONG ValueType,
[out] PVOID ValueData,
[out] PULONG ResultLength
);
Parameter
[in] PrimaryHandle
Handel ke kunci yang pertama kali digunakan untuk mengkueri entri nilai. Handel ini dibuat oleh panggilan yang berhasil ke ZwCreateKey atau ZwOpenKey.
[in] FallbackHandle
Handel yang digunakan untuk mengkueri kunci jika nilai tidak ditemukan menggunakan handel yang ditentukan oleh PrimaryHandle.
[in] ValueName
Penunjuk ke string yang berisi nama nilai yang akan diambil datanya.
[in] ValueLength
Menentukan ukuran, dalam byte, dari string ValueName .
[Out] ValueType
Penunjuk ke variabel ULONG yang menerima jenis nilai yang sedang dikueri.
[out] ValueData
Penunjuk ke buffer yang menerima data nilai.
[out] ResultLength
Penunjuk ke variabel yang menerima ukuran data nilai, dalam byte. Jika nilai yang dikembalikan STATUS_SUCCESS, menunjukkan jumlah byte yang ditulis ke buffer ValueData . Jika panggilan mengembalikan STATUS_BUFFER_OVERFLOW, menunjukkan jumlah byte yang diperlukan. Penelepon dapat menggunakan nilai tersebut untuk menentukan ukuran buffer ValueData yang diperlukan untuk menyimpan informasi data.
Nilai kembali
Mengembalikan STATUS_SUCCESS pada keberhasilan, atau kode kesalahan yang sesuai pada kegagalan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 10, version 1809 |
| Header | ntddk.h (termasuk wdm.h) |
| Pustaka | NtosKrnl.lib |
| IRQL | PASSIVE_LEVEL |