Função RegDeleteKeyTransactedA (winreg.h)

Artigo
11/20/2024

Exclui uma subchave e seus valores da exibição específica da plataforma especificada do registro como uma operação transacionada. Observe que os nomes de chave não diferenciam maiúsculas de minúsculas.

Sintaxe

LSTATUS RegDeleteKeyTransactedA(
  [in] HKEY   hKey,
  [in] LPCSTR lpSubKey,
  [in] REGSAM samDesired,
       DWORD  Reserved,
  [in] HANDLE hTransaction,
       PVOID  pExtendedParameter
);

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 pelo RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyExou função regOpenKeyTransacted. Também pode ser uma das seguintes chaves predefinidas :

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
KEY_WOW64_32KEY 0x0200	Exclua a chave do modo de exibição do Registro de 32 bits.
KEY_WOW64_64KEY 0x0100	Exclua a chave do modo de exibição do Registro de 64 bits.

Reserved

Esse parâmetro é reservado e deve ser zero.

[in] hTransaction

Um identificador para uma transação ativa. Esse identificador é retornado pela função CreateTransaction.

pExtendedParameter

Esse parâmetro é reservado e deve ser NULL.

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 FormatMessage com o sinalizador FORMAT_MESSAGE_FROM_SYSTEM para obter uma descrição genérica do erro.

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 RegDeleteTree ou SHDeleteKey.

Se a função for bem-sucedida, RegDeleteKeyTransacted removerá a chave especificada do registro. A chave inteira, incluindo todos os seus valores, é removida. Para remover a árvore inteira como uma operação transacionada, use a função RegDeleteTree com um identificador retornado de RegCreateKeyTransacted ou RegOpenKeyTransacted.

Nota

O cabeçalho winreg.h define RegDeleteKeyTransacted como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de 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 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [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

RegCreateKeyTransacted

RegOpenKeyTransacted

Funções do Registro

do Redirecionador do Registro

Compartilhar via