Funzione RtlCheckRegistryKey (wdm.h)

Articolo
02/29/2024

La routine RtlCheckRegistryKey controlla l'esistenza di una chiave denominata specificata nel Registro di sistema.

Sintassi

NTSYSAPI NTSTATUS RtlCheckRegistryKey(
  [in] ULONG RelativeTo,
  [in] PWSTR Path
);

Parametri

[in] RelativeTo

Specifica se Path è un percorso del Registro di sistema assoluto o è relativo a un percorso di chiave predefinito come uno dei seguenti.

Valore	Significato
RTL_REGISTRY_ABSOLUTE	Percorso è un percorso del Registro di sistema assoluto.
RTL_REGISTRY_CONTROL	Il percorso è relativo a \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_DEVICEMAP	Il percorso è relativo a \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_SERVICES	Il percorso è relativo a \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_USER	Il percorso è relativo alle impostazioni del Registro di sistema per l'utente corrente. Per un processo di sistema, questo è \Users\. Impostazione predefinita. Equivale a HKEY_CURRENT_USER in modalità utente.
RTL_REGISTRY_WINDOWS_NT	Il percorso è relativo a \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_HANDLE	Questo valore non deve essere passato a questa routine. Nonostante la ridondanza di un controllo per l'esistenza di una chiave già aperta, ha l'effetto collaterale della chiusura dell'handle passato.

[in] Path

Specifica il percorso del Registro di sistema in base al valore RelativeTo . Se RTL_REGISTRY_HANDLE è impostato, path è un handle da usare direttamente.

Valore restituito

Se la chiave denominata specificata esiste nel Registro di sistema lungo il percorso relativo specificato, RtlCheckRegistryKey restituisce STATUS_SUCCESS.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Vedi anche

RtlQueryRegistryValues

Condividi tramite