NTSTATUS
RtlCheckRegistryKey(
IN ULONG RelativeTo,
IN PWSTR Path
);
RtlCheckRegistryKey checks for the existence of a given named key in the registry.
Parameters
RelativeTo
Specifies whether Path is an absolute registry path or is relative to a predefined key path as one of the following:
| Value | Meaning | ||||||||
| RTL_REGISTRY_ABSOLUTE | |||||||||
| Path is an absolute registry path. | |||||||||
| RTL_REGISTRY_SERVICES | |||||||||
| Path is relative to \Registry\Machine\System\CurrentControlSet\Services. | |||||||||
| RTL_REGISTRY_CONTROL | |||||||||
| Path is relative to \Registry\Machine\System\CurrentControlSet\Control. | |||||||||
| RTL_REGISTRY_WINDOWS_NT | |||||||||
| Path is relative to \Registry\Machine\Software\Microsoft\ Windows NT\CurrentVersion. |
|||||||||
| RTL_REGISTRY_DEVICEMAP | |||||||||
| Path is relative to \Registry\Machine\Hardware\DeviceMap. | |||||||||
| RTL_REGISTRY_USER | |||||||||
| Path is relative to \Registry\User\CurrentUser. | |||||||||
| RTL_REGISTRY_OPTIONAL | |||||||||
| Specifies that the key referenced by this parameter and the Path parameter are optional. | |||||||||
| RTL_REGISTRY_HANDLE | |||||||||
| Specifies that the Path parameter is actually a registry handle to use. This value is optional. | |||||||||
Path
Specifies the registry path according to the RelativeTo value. If RTL_REGISTRY_HANDLE is set, Path is a handle to be used directly.
Return Value
If the given, named key exists in the registry along the given relative path, RtlCheckRegistryKey returns STATUS_SUCCESS.
Comments
Callers of RtlCheckRegistryKey must be running at IRQL PASSIVE_LEVEL.
See Also