Funzione RtlCheckRegistryKey (wdm.h)

  • Articolo

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