Função RtlCreateRegistryKey (wdm.h)

Artigo
02/29/2024

A rotina RtlCreateRegistryKey adiciona um objeto de chave no registro ao longo de um determinado caminho relativo.

Sintaxe

NTSYSAPI NTSTATUS RtlCreateRegistryKey(
  [in] ULONG RelativeTo,
  [in] PWSTR Path
);

Parâmetros

[in] RelativeTo

Especifica se Path é um caminho absoluto do Registro ou se é relativo a um caminho de chave predefinido como um dos seguintes.

Valor	Significado
RTL_REGISTRY_ABSOLUTE	Path é um caminho absoluto do Registro.
RTL_REGISTRY_SERVICES	O caminho é relativo a \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_CONTROL	O caminho é relativo a \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_WINDOWS_NT	O caminho é relativo a \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_DEVICEMAP	O caminho é relativo a \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_USER	O caminho é relativo a \Registry\User\CurrentUser. (Para um processo do sistema, isso é \Users\. Padrão.)

[in] Path

Especifica o caminho do Registro de acordo com o valor RelativeTo .

Retornar valor

RtlCreateRegistryKey retornará STATUS_SUCCESS se a chave for criada.

Comentários

RtlCreateRegistryKey cria apenas as chaves especificadas. Ele não cria chaves ausentes no caminho para a chave especificada. Se alguma chave no caminho estiver ausente, a chamada falhará. Para garantir que todas as chaves no caminho existam, você deve chamar RtlCreateRegistryKey uma vez para cada chave no caminho.

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