Función RtlCheckRegistryKey (wdm.h)

  • Artículo

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

Consulte también

RtlQueryRegistryValues