IoOpenDriverRegistryKey-Funktion (wdm.h)
Die IoOpenDriverRegistryKey Routine gibt ein Handle an einen treiberspezifischen Registrierungsschlüssel für einen bestimmten Treiber zurück.
Syntax
NTSTATUS IoOpenDriverRegistryKey(
[in] PDRIVER_OBJECT DriverObject,
[in] DRIVER_REGKEY_TYPE RegKeyType,
[in] ACCESS_MASK DesiredAccess,
[in] ULONG Flags,
[out] PHANDLE DriverRegKey
);
Parameter
[in] DriverObject
Ein Zeiger auf eine DRIVER_OBJECT Struktur. Diese Struktur muss das Treiberobjekt für den aufrufenden Treiber sein.
[in] RegKeyType
Eine Aufzählung vom Typ DRIVER_REGKEY_TYPE, die den Typ des angeforderten Registrierungsschlüssels angibt.
[in] DesiredAccess
Gibt den ACCESS_MASK Wert an, der die für den Schlüssel erforderlichen Zugriffsrechte darstellt. Eine Beschreibung der einzelnen KEY_XXX Zugriffsrechte finden Sie unter ZwCreateKey-.
[in] Flags
Auf Null festgelegt.
[out] DriverRegKey
Ein Zeiger auf die HANDLE-Variable, die bei erfolgreicher Rückgabe ein Handle für den angeforderten Registrierungsschlüssel enthält.
Rückgabewert
IoOpenDriverRegistryKey gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ein Handle für den angeforderten Registrierungsschlüssel geöffnet hat.
Bemerkungen
Der Treiber muss ZwClose- aufrufen, um das von dieser Routine zurückgegebene Handle zu schließen, wenn der Zugriff nicht mehr benötigt wird.
Die von dieser Routine geöffneten Registrierungsschlüssel sind nicht unvolatile.
Verwenden Sie zum Bereitstellen von Schlüsseln und Werten unter dem unveränderlichen DriverRegKeyParameters Registrierungsschlüssel eine AddReg-Direktive aus einem Dienstinstallationsabschnitt, um auf einen Add-Registry-Section-Abschnitt Abschnitt zu verweisen, der Einträge mit einem Reg-Root von HKR und einem Unterschlüssel von Parametersenthält.
Aufrufer von IoOpenDriverRegistryKey- müssen unter IRQL = PASSIVE_LEVEL im Kontext eines Systemthreads ausgeführt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1803 |
| Header- | wdm.h (include wdm.h, ntddk.h, or ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | PASSIVE_LEVEL |