Clase de CRegKey

Artículo
02/19/2013

Esta clase proporciona métodos para manipular entradas en el registro del sistema.

Importante
Esta clase y sus miembros no se pueden utilizar en las aplicaciones que se ejecutan en Windows en tiempo de ejecución.

class CRegKey

Members

Constructores públicos

Name	Descripción
CRegKey::CRegKey	el constructor.
CRegKey::~CRegKey	El destructor.

Métodos públicos

Name	Descripción
CRegKey::Attach	Llame a este método para asociar un HKEY al objeto de CRegKey estableciendo el identificador del miembro de m_hKey a hKey.
CRegKey::Close	Llame a este método para liberar el identificador del miembro de m_hKey y para establecerlo en NULL.
CRegKey::Create	Llame a este método para crear la clave especificada, si no existe como subclave de hKeyParent.
CRegKey::DeleteSubKey	Llame a este método para quitar la clave especificada del registro.
CRegKey::DeleteValue	Llame a este método para quitar un campo de Valor de m_hKey.
CRegKey::Detach	Llame a este método para desasociar el identificador del miembro de m_hKey del objeto de CRegKey y m_hKey determinado en NULL.
CRegKey::EnumKey	Llame a este método para enumerar las subclaves de la clave del Registro abierto.
CRegKey::Flush	Llame a este método para escribir todos los atributos de clave del Registro abierto en el registro.
CRegKey::GetKeySecurity	Llame a este método para recuperar una copia del descriptor de seguridad que protege la clave del Registro abierto.
CRegKey::NotifyChangeKeyValue	Este método notifica al llamador sobre cambios en los atributos o al contenido de clave del Registro abierto.
CRegKey::Open	Llame a este método para abrir la clave especificada y m_hKey determinado en el identificador de esta clave.
CRegKey::QueryBinaryValue	Llame a este método para recuperar los datos binarios de un nombre de valor especificado.
CRegKey::QueryDWORDValue	Llame a este método para recuperar los datos de DWORD para un nombre de valor especificado.
CRegKey::QueryGUIDValue	Llame a este método para recuperar los datos del GUID para un nombre de valor especificado.
CRegKey::QueryMultiStringValue	Llame a este método para recuperar los datos multistring para un nombre de valor especificado.
CRegKey::QueryQWORDValue	Llame a este método para recuperar los datos de QWORD para un nombre de valor especificado.
CRegKey::QueryStringValue	Llame a este método para recuperar los datos de cadena para un nombre de valor especificado.
CRegKey::QueryValue	Llame a este método para recuperar los datos del campo de valor especificado de m_hKey.Versiones anteriores de este método se admiten y se marcan ya no como ATL_DEPRECATED.
CRegKey::RecurseDeleteKey	Llame a este método para quitar la clave especificada del registro y explícitamente para quitar cualquier subclave.
CRegKey::SetBinaryValue	Llame a este método para establecer el valor binario de la clave del Registro.
CRegKey::SetDWORDValue	Llame a este método para establecer el valor DWORD de la clave del Registro.
CRegKey::SetGUIDValue	Llame a este método para establecer el valor de GUID de la clave del Registro.
CRegKey::SetKeySecurity	Llame a este método para establecer la seguridad de la clave del Registro.
CRegKey::SetKeyValue	Llame a este método para almacenar datos en un campo de valor especificado de una clave especificada.
CRegKey::SetMultiStringValue	Llame a este método para establecer el valor multistring de la clave del Registro.
CRegKey::SetQWORDValue	Llame a este método para establecer el valor de QWORD de la clave del Registro.
CRegKey::SetStringValue	Llame a este método para establecer el valor de cadena de la clave del Registro.
CRegKey::SetValue	Llame a este método para almacenar datos en el campo de valor especificado de m_hKey.Versiones anteriores de este método se admiten y se marcan ya no como ATL_DEPRECATED.

Operadores públicos

Name	Descripción
CRegKey::operator HKEY	convierte un objeto de CRegKey a un HKEY.
CRegKey::operator =	Operador de asignación.

Miembros de datos públicos

Name	Descripción
CRegKey::m_hKey	Contiene un identificador de clave de Registro asociado al objeto de CRegKey .
CRegKey::m_pTM	Puntero al objeto de CAtlTransactionManager

Comentarios

CRegKey proporciona métodos para crear y eliminar claves y valores del sistema.El registro contiene un conjunto instalación- específico de definiciones para los componentes del sistema, como números de versión de software, asignaciones lógico-a- físicas de hardware instalado, y objetos COM.

CRegKey proporciona una interfaz de programación al registro del sistema para un equipo determinado.Por ejemplo, abrir un clave de Registro concreto, llamada CRegKey::Open.Para recuperar o modificar un valor de datos, una llamada CRegKey::QueryValue o CRegKey::SetValue, respectivamente.Para cerrar una clave, llame a CRegKey::Close.

Al cerrar una clave, los datos del Registro escriben (vaciado) en el disco duro.Este proceso puede tardar varios segundos.Si su aplicación debe explícitamente escribir datos del Registro en el disco duro, puede llamar a la función de RegFlushKey Win32.Sin embargo, RegFlushKey utiliza muchos recursos del sistema y debe invocarse únicamente cuando sea absolutamente necesario.

Nota sobre la seguridad
Cualquier método que permite que el llamador especifique una ubicación del registro tiene el potencial para leer datos que no se han confirmado.Los métodos que utilizan de RegQueryValueEx deben tener en cuenta que esta función no controla las cadenas que son NULL finalizados.Ambas condiciones deben comprobar para el código de llamada.

Requisitos

encabezado: atlbase.h

Vea también

Clase de CRegKey

Members

Constructores públicos

Métodos públicos

Operadores públicos

Miembros de datos públicos

Comentarios

Requisitos

Vea también

Referencia

Conceptos

Otros recursos

Recursos adicionales