Función RtlCheckRegistryKey (wdm.h)
La rutina RtlCheckRegistryKey comprueba la existencia de una clave con nombre determinada en el Registro.
Sintaxis
NTSYSAPI NTSTATUS RtlCheckRegistryKey(
[in] ULONG RelativeTo,
[in] PWSTR Path
);
Parámetros
[in] RelativeTo
Especifica si Path es una ruta de acceso absoluta del Registro o es relativa a una ruta de acceso de clave predefinida como una de las siguientes.
| Valor | Significado |
|---|---|
| RTL_REGISTRY_ABSOLUTE | Path es una ruta de acceso absoluta del Registro. |
| RTL_REGISTRY_CONTROL | La ruta de acceso es relativa a \Registry\Machine\System\CurrentControlSet\Control. |
| RTL_REGISTRY_DEVICEMAP | La ruta de acceso es relativa a \Registry\Machine\Hardware\DeviceMap. |
| RTL_REGISTRY_SERVICES | La ruta de acceso es relativa a \Registry\Machine\System\CurrentControlSet\Services. |
| RTL_REGISTRY_USER | La ruta de acceso es relativa a la configuración del Registro para el usuario actual. (Para un proceso del sistema, es \Users\. Valor predeterminado). Esto equivale a HKEY_CURRENT_USER en modo de usuario. |
| RTL_REGISTRY_WINDOWS_NT | La ruta de acceso es relativa a \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion. |
| RTL_REGISTRY_HANDLE | Este valor no se debe pasar a esta rutina. A pesar de la redundancia de una comprobación de la existencia de una clave ya abierta, tiene el efecto secundario de cerrar el controlador pasado. |
[in] Path
Especifica la ruta de acceso del Registro según el valor RelativeTo . Si se establece RTL_REGISTRY_HANDLE, Path es un identificador que se usará directamente.
Valor devuelto
Si la clave con nombre especificada existe en el Registro a lo largo de la ruta de acceso relativa especificada, RtlCheckRegistryKey devuelve STATUS_SUCCESS.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de Windows. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |