Função NtRenameKey (winternl.h)
[Essa função pode ser alterada ou removida do Windows sem aviso prévio. ]
Altera o nome da chave do Registro especificada.
Sintaxe
__kernel_entry NTSTATUS NtRenameKey(
[in] HANDLE KeyHandle,
[in] PUNICODE_STRING NewName
);
Parâmetros
[in] KeyHandle
Um identificador para a chave a ser renomeada. O identificador deve ser aberto com o direito de acesso KEY_WRITE.
[in] NewName
Um ponteiro para uma cadeia de caracteres UNICODE que é o novo nome da chave.
Retornar valor
Retorna um código de erro ou NTSTATUS . Um código de erro de STATUS_ACCESS_DENIED indica que o chamador não tem os direitos de acesso necessários para a chave do Registro especificada ou subchaves.
Os formulários e a significância dos códigos de erro NTSTATUS estão listados no arquivo de cabeçalho Ntstatus.h disponível no WDK e são descritos na documentação do WDK.
Comentários
Essa função não tem nenhum arquivo de cabeçalho associado. Você também pode usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Ntdll.dll.
A função NtRenameKey pode ser usada para renomear uma subárvore inteira do Registro. O chamador deve ter acesso KEY_CREATE_SUB_KEY ao pai da chave especificada e ao acesso DELETE a toda a subárvore que está sendo renomeada.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | winternl.h |
| Biblioteca | ntdll.lib |
| DLL | ntdll.dll |