Função RtlCheckRegistryKey (wdm.h)

  • Artigo

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

Confira também

RtlQueryRegistryValues