Classe de CRegKey

Essa classe fornece métodos para manipular as entradas no Registro do sistema.

Importante
Essa classe e seus membros não podem ser usados em aplicativos executados em tempo de execução do windows.

class CRegKey

Membros

Construtores public

Nome	Descrição
CRegKey::CRegKey	o construtor.
CRegKey::~CRegKey	O destrutor.

Métodos públicos

Nome	Descrição
CRegKey::Attach	Chamar esse método para anexar um HKEY ao objeto de CRegKey definindo a alça de membro de m_hKey a hKey.
CRegKey::Close	Chamar este método para liberar a alça de membro de m_hKey e para defini-la PARA ANULAR.
CRegKey::Create	Chamar esse método para criar a chave especificada, se não existir como uma subchave de hKeyParent.
CRegKey::DeleteSubKey	Chamar esse método para remover a chave de Registro especificada.
CRegKey::DeleteValue	Chamar esse método para remover um campo de valor de m_hKey.
CRegKey::Detach	Chamar esse método para desanexe a alça de membro de m_hKey do objeto de CRegKey e set. m_hKey ao NULL
CRegKey::EnumKey	Chamar esse método para enumerar as subchaves da chave do Registro aberta.
CRegKey::Flush	Chamar esse método para gravar todos os atributos de chave do Registro aberta no Registro.
CRegKey::GetKeySecurity	Chamar esse método para recuperar uma cópia do descritor de segurança que protege a chave do Registro aberta.
CRegKey::NotifyChangeKeyValue	Este método notifica o chamador sobre alterações aos atributos ou ao conteúdo da chave do Registro aberta.
CRegKey::Open	Chamar esse método para abrir a chave especificada e m_hKey ajustado para o identificador de essa chave.
CRegKey::QueryBinaryValue	Chamar esse método para recuperar os dados binários para um nome especificado de valor.
CRegKey::QueryDWORDValue	Chamar esse método para recuperar os dados DWORD para um nome especificado de valor.
CRegKey::QueryGUIDValue	Chamar esse método para recuperar dados de GUID para um nome especificado de valor.
CRegKey::QueryMultiStringValue	Chamar esse método para recuperar os dados multistring para um nome especificado de valor.
CRegKey::QueryQWORDValue	Chamar esse método para recuperar dados de QWORD para um nome especificado de valor.
CRegKey::QueryStringValue	Chamar esse método para recuperar dados da cadeia de caracteres para um nome especificado de valor.
CRegKey::QueryValue	Chamar esse método para recuperar os dados para o campo de valor especificado de m_hKey.As versões anteriores de este método não são suportadas e marcadas como ATL_DEPRECATED.
CRegKey::RecurseDeleteKey	Chamar esse método para remover a chave de Registro especificada e remover explicitamente todas as subchaves.
CRegKey::SetBinaryValue	Chamar esse método para definir o valor binário da chave do Registro.
CRegKey::SetDWORDValue	Chamar esse método para definir o valor DWORD da chave do Registro.
CRegKey::SetGUIDValue	Chamar esse método para definir o valor GUID da chave do Registro.
CRegKey::SetKeySecurity	Chamar esse método para definir a segurança da chave do Registro.
CRegKey::SetKeyValue	Chamar esse método para armazenar dados no campo especificado o valor de uma chave especificada.
CRegKey::SetMultiStringValue	Chamar esse método para definir o valor multistring da chave do Registro.
CRegKey::SetQWORDValue	Chamar esse método para definir o valor de QWORD da chave do Registro.
CRegKey::SetStringValue	Chamar esse método para definir o valor da cadeia de caracteres de chave do Registro.
CRegKey::SetValue	Chamar esse método para armazenar dados em um campo de valor especificado de m_hKey.As versões anteriores de este método não são suportadas e marcadas como ATL_DEPRECATED.

Operadores públicos

Nome	Descrição
CRegKey::operator HKEY	Converte um objeto de CRegKey a um HKEY.
CRegKey::operator =	Operador de atribuição.

Membros públicos de dados

Nome	Descrição
CRegKey::m_hKey	Contém um identificador de chave do Registro associado com o objeto de CRegKey .
CRegKey::m_pTM	Ponteiro para o objeto de CAtlTransactionManager

Comentários

CRegKey fornece métodos para criar e excluir chaves e valores no Registro do sistema.O Registro contém um conjunto instalação- específico de definições para componentes do sistema, como números de versão de software, mapeamentos de lógico-à- discussão de hardware instalado, e objetos COM.

CRegKey fornece uma interface de programação do Registro do sistema para um determinado computador.Por exemplo, para abrir uma chave do Registro específica, chame CRegKey::Open.Para recuperar ou modificar um valor de dados, uma chamada CRegKey::QueryValue ou um CRegKey::SetValue, respectivamente.Para fechar uma chave, chame CRegKey::Close.

Quando você fechar uma chave do Registro, os dados são gravados (solto) no disco rígido.Esse processo pode levar alguns segundos.Se seu aplicativo deve explicitamente gravar dados de Registro no disco rígido, você pode chamar a função de RegFlushKey Win32.Em o entanto, RegFlushKey usa vários recursos do sistema e deve ser chamado somente quando necessário absolutamente.

Observação de segurança
Todos os métodos que permitem que o chamador especificar um local de Registro têm o potencial lê os dados que não podem ser confiáveis.Os métodos que utilizam RegQueryValueEx devem levar em consideração que essa função não trata explicitamente as cadeias de caracteres que são terminadas NULAS.Ambas as condições devem ser marcadas para o código de chamada.

Requisitos

Cabeçalho: atlbase.h

Consulte também

Referência

Registry Overview

Registry Functions

Registry Value Types

Conceitos

Exemplo do DCOM

Outros recursos

Visão geral da classe de ATL