Função RtlCreateRegistryKey (wdm.h)
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 |