Função RtlCheckRegistryKey (wdm.h)
A rotina RtlCheckRegistryKey verifica a existência de uma determinada chave nomeada no registro.
Sintaxe
NTSYSAPI NTSTATUS RtlCheckRegistryKey(
[in] ULONG RelativeTo,
[in] PWSTR Path
);
Parâmetros
[in] RelativeTo
Especifica se Path é um caminho absoluto do Registro ou é relativo a um caminho de chave predefinido como um dos seguintes.
| Valor | Significado |
|---|---|
| RTL_REGISTRY_ABSOLUTE | Path é um caminho absoluto do Registro. |
| RTL_REGISTRY_CONTROL | O caminho é relativo a \Registry\Machine\System\CurrentControlSet\Control. |
| RTL_REGISTRY_DEVICEMAP | O caminho é relativo a \Registry\Machine\Hardware\DeviceMap. |
| RTL_REGISTRY_SERVICES | O caminho é relativo a \Registry\Machine\System\CurrentControlSet\Services. |
| RTL_REGISTRY_USER | O caminho é relativo às configurações do Registro para o usuário atual. (Para um processo do sistema, isso é \Users\. Padrão.) Isso é equivalente a HKEY_CURRENT_USER no modo de usuário. |
| RTL_REGISTRY_WINDOWS_NT | O caminho é relativo a \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion. |
| RTL_REGISTRY_HANDLE | Esse valor não deve ser passado para essa rotina. Apesar da redundância de uma marcar para a existência de uma chave já aberta, ela tem o efeito colateral de fechar o identificador passado. |
[in] Path
Especifica o caminho do Registro de acordo com o valor RelativeTo . Se RTL_REGISTRY_HANDLE estiver definido, Path será um identificador a ser usado diretamente.
Retornar valor
Se a chave nomeada fornecida existir no registro ao longo do caminho relativo fornecido, RtlCheckRegistryKey retornará STATUS_SUCCESS.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 2000 e versões posteriores do Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |