Classe de CRegKey

Cette classe fournit des méthodes pour manipuler des entrées dans la base de registres.

Important

Cette classe et ses membres ne peuvent pas être utilisés dans les applications qui s'exécutent dans les fenêtres d'exécution.

class CRegKey

Membres

Constructeurs publics

Nom	Description
CRegKey::CRegKey	Constructeur.
CRegKey::~CRegKey	Le destructeur.

Méthodes publiques

Nom	Description
CRegKey::Attach	Appelez cette méthode pour attacher un HKEY à l'objet d' CRegKey en définissant le handle membre de m_hKey à hKey.
CRegKey::Close	Appelez cette méthode pour libérer le handle membre de m_hKey et le définir la valeur NULL.
CRegKey::Create	Appelez cette méthode pour créer la clé spécifiée, si elle n'existe pas comme valeur d' hKeyParent.
CRegKey::DeleteSubKey	Appelez cette méthode pour supprimer la clé spécifiée du Registre.
CRegKey::DeleteValue	Appelez cette méthode pour supprimer un champ de valeur de m_hKey.
CRegKey::Detach	Appelez cette méthode pour détacher le handle membre de m_hKey de l'objet d' CRegKey et définissez m_hKey la valeur NULL.
CRegKey::EnumKey	Appelez cette méthode pour énumérer les sous-clés de la clé de Registre ouverte.
CRegKey::Flush	Appelez cette méthode pour écrire tous les attributs de la clé de Registre ouverte dans le Registre.
CRegKey::GetKeySecurity	Appelez cette méthode pour récupérer une copie du modèle de sécurité protégeant la clé de Registre ouverte.
CRegKey::NotifyChangeKeyValue	Cette méthode signale l'appelant sur les modifications apportées aux attributs ou au contenu de la clé de Registre ouverte.
CRegKey::Open	Appelez cette méthode pour ouvrir la clé spécifiée et définissez m_hKey au handle de cette clé.
CRegKey::QueryBinaryValue	Appelez cette méthode pour récupérer les données binaires d'un nom de valeur spécifiée.
CRegKey::QueryDWORDValue	Appelez cette méthode pour récupérer les données DWORD pour un nom de valeur spécifiée.
CRegKey::QueryGUIDValue	Appelez cette méthode pour récupérer les données du GUID pour le nom de la valeur spécifiée.
CRegKey::QueryMultiStringValue	Appelez cette méthode pour récupérer les données à plusieurs chaînes pour un nom de valeur spécifiée.
CRegKey::QueryQWORDValue	Appelez cette méthode pour récupérer les données de QWORD pour un nom de valeur spécifiée.
CRegKey::QueryStringValue	Appelez cette méthode pour récupérer les données de chaîne pour le nom de la valeur spécifiée.
CRegKey::QueryValue	Appelez cette méthode pour récupérer les données du champ de valeur spécifié de m_hKey.Les versions antérieures de cette méthode sont plus prises en charge et ne sont marquées comme ATL_DEPRECATED.
CRegKey::RecurseDeleteKey	Appelez cette méthode pour supprimer la clé spécifiée du Registre et pour supprimer explicitement toutes les sous-clés.
CRegKey::SetBinaryValue	Appelez cette méthode pour définir la valeur binaire de la clé de Registre.
CRegKey::SetDWORDValue	Appelez cette méthode pour définir la valeur DWORD de la clé de Registre.
CRegKey::SetGUIDValue	Appelez cette méthode pour définir la valeur GUID de la clé de Registre.
CRegKey::SetKeySecurity	Appelez cette méthode pour définir la sécurité de la clé de Registre.
CRegKey::SetKeyValue	Appelez cette méthode pour enregistrer des données dans un domaine spécifié de valeur d'une clé spécifiée.
CRegKey::SetMultiStringValue	Appelez cette méthode pour affecter la valeur à plusieurs chaînes de la clé de Registre.
CRegKey::SetQWORDValue	Appelez cette méthode pour définir la valeur de QWORD de la clé de Registre.
CRegKey::SetStringValue	Appelez cette méthode pour définir la valeur de chaîne de la clé de Registre.
CRegKey::SetValue	Appelez cette méthode pour enregistrer des données dans le domaine de valeur spécifié de m_hKey.Les versions antérieures de cette méthode sont plus prises en charge et ne sont marquées comme ATL_DEPRECATED.

Opérateurs publics

Nom	Description
CRegKey::operator HKEY	Convertit un objet d' CRegKey à un HKEY.
CRegKey::operator =	Opérateur d'assignation

Données membres publiques

Nom	Description
CRegKey::m_hKey	Contient un handle de la clé de Registre associé à l'objet d' CRegKey .
CRegKey::m_pTM	Pointeur vers l'objet d' CAtlTransactionManager

Notes

CRegKey fournit des méthodes pour créer et touches et valeurs d'effacement dans la base de registres.Le Registre contient un jeu d'installation- spécifique de définitions pour les composants système, tels que les numéros de version du logiciel, des mappages de logique-à- physique de matériel installé, et des objets COM.

CRegKey fournit une interface de programmation à la base de registres pour un ordinateur donné.Par exemple, pour ouvrir une clé de Registre spécifique, appelez CRegKey::Open.Pour récupérer ou modifier une valeur de données, un appel CRegKey::QueryValue ou un CRegKey::SetValue, respectivement.Pour fermer une clé, appelez CRegKey::Close.

Lorsque vous fermez une clé, ses données du Registre sont écrites (vidé) sur le disque dur.Ce processus peut prendre quelques secondes.Si votre application doit explicitement écrire des données de Registre sur le disque dur, vous pouvez appeler la fonction de RegFlushKey Win32.Toutefois, RegFlushKey utilise beaucoup de ressources système et doit être appelé uniquement si absolument nécessaire.

Note de sécurité
Toutes les méthodes qui permettent à l'appelant de spécifier un emplacement de Registre ont la possibilité de lire les données qui ne peuvent pas être de confiance.Les méthodes qui se servent de RegQueryValueEx doivent prendre en compte que cette fonction ne gère pas explicitement les chaînes qui sont NULL terminées.Les deux conditions doivent être examinées pour rechercher par le code appelant.

Configuration requise

Header: atlbase.h

Voir aussi

Référence

Registry Overview

Registry Functions

Registry Value Types

Concepts

Exemple DCOM

Autres ressources

Vue d'ensemble de la classe ATL