Função RegDeleteKeyExA (winreg.h)
Exclui uma subchave e seus valores da exibição específica da plataforma especificada do Registro. Observe que os nomes de chave não diferenciam maiúsculas de minúsculas.
Para excluir uma subchave como uma operação transacionada, chame a função RegDeleteKeyTransacted.
Sintaxe
LSTATUS RegDeleteKeyExA(
[in] HKEY hKey,
[in] LPCSTR lpSubKey,
[in] REGSAM samDesired,
DWORD Reserved
);
Parâmetros
[in] hKey
Um identificador para uma chave aberta do Registro. Os direitos de acesso dessa chave não afetam a operação de exclusão. Para obter mais informações sobre direitos de acesso, consulte de Segurança de Chave de Registro e Direitos de Acesso.
Esse identificador é retornado pela função RegCreateKeyEx
- HKEY_CLASSES_ROOT
- HKEY_CURRENT_CONFIG
- HKEY_CURRENT_USER
- HKEY_LOCAL_MACHINE
- HKEY_USERS
[in] lpSubKey
O nome da chave a ser excluída. Essa chave deve ser uma subchave da chave especificada pelo valor do parâmetro hKey.
A função abre a subchave com o direito de acesso DELETE.
Os nomes de chave não diferenciam maiúsculas de minúsculas.
O valor desse parâmetro não pode ser NULL.
[in] samDesired
Uma máscara de acesso especifica a exibição específica da plataforma do Registro.
| Valor | Significado |
|---|---|
|
Exclua a chave do modo de exibição do Registro de 32 bits. |
|
Exclua a chave do modo de exibição do Registro de 64 bits. |
Reserved
Esse parâmetro é reservado e deve ser zero.
Valor de retorno
Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.
Se a função falhar, o valor retornado será um código de erro diferente de zero definido em Winerror.h. Você pode usar a função
Observações
Uma chave excluída não será removida até que o último identificador seja fechado.
Em WOW64, aplicativos de 32 bits exibem uma árvore do Registro separada da árvore do Registro que os aplicativos de 64 bits exibem. Essa função permite que um aplicativo exclua uma entrada na exibição alternativa do Registro.
A subchave a ser excluída não deve ter subchaves. Para excluir uma chave e todas as suas subchaves, você precisa enumerar as subchaves e excluí-las individualmente. Para excluir chaves recursivamente, use a função
Se a função for bem-sucedida, RegDeleteKeyEx removerá a chave especificada do registro. A chave inteira, incluindo todos os seus valores, é removida.
Nota
Em versões herdadas do Windows, essa API também é exposta por kernel32.dll.
Nota
O cabeçalho winreg.h define RegDeleteKeyEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista, Windows XP Professional x64 Edition [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2008, Windows Server 2003 com SP1 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winreg.h (inclua Windows.h) |
| biblioteca | Advapi32.lib |
| de DLL |
Advapi32.dll |
Consulte também
RegCreateKeyEx
RegDeleteKeyTransacted
RegOpenKeyEx