CRegKey, classe
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 |
---|---|
Constructeur. |
|
Le destructeur. |
Méthodes publiques
Nom |
Description |
---|---|
Appelez cette méthode pour attacher un HKEY à l'objet d' CRegKey en définissant le handle membre de m_hKey à hKey. |
|
Appelez cette méthode pour libérer le handle membre de m_hKey et le définir la valeur NULL. |
|
Appelez cette méthode pour créer la clé spécifiée, si elle n'existe pas comme valeur d' hKeyParent. |
|
Appelez cette méthode pour supprimer la clé spécifiée du Registre. |
|
Appelez cette méthode pour supprimer un champ de valeur de m_hKey. |
|
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. |
|
Appelez cette méthode pour énumérer les sous-clés de la clé de Registre ouverte. |
|
Appelez cette méthode pour écrire tous les attributs de la clé de Registre ouverte dans le Registre. |
|
Appelez cette méthode pour récupérer une copie du modèle de sécurité protégeant la clé de Registre ouverte. |
|
Cette méthode signale l'appelant sur les modifications apportées aux attributs ou au contenu de la clé de Registre ouverte. |
|
Appelez cette méthode pour ouvrir la clé spécifiée et définissez m_hKey au handle de cette clé. |
|
Appelez cette méthode pour récupérer les données binaires d'un nom de valeur spécifiée. |
|
Appelez cette méthode pour récupérer les données DWORD pour un nom de valeur spécifiée. |
|
Appelez cette méthode pour récupérer les données du GUID pour le nom de la valeur spécifiée. |
|
Appelez cette méthode pour récupérer les données à plusieurs chaînes pour un nom de valeur spécifiée. |
|
Appelez cette méthode pour récupérer les données de QWORD pour un nom de valeur spécifiée. |
|
Appelez cette méthode pour récupérer les données de chaîne pour le nom de la valeur spécifiée. |
|
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. |
|
Appelez cette méthode pour supprimer la clé spécifiée du Registre et pour supprimer explicitement toutes les sous-clés. |
|
Appelez cette méthode pour définir la valeur binaire de la clé de Registre. |
|
Appelez cette méthode pour définir la valeur DWORD de la clé de Registre. |
|
Appelez cette méthode pour définir la valeur GUID de la clé de Registre. |
|
Appelez cette méthode pour définir la sécurité de la clé de Registre. |
|
Appelez cette méthode pour enregistrer des données dans un domaine spécifié de valeur d'une clé spécifiée. |
|
Appelez cette méthode pour affecter la valeur à plusieurs chaînes de la clé de Registre. |
|
Appelez cette méthode pour définir la valeur de QWORD de la clé de Registre. |
|
Appelez cette méthode pour définir la valeur de chaîne de la clé de Registre. |
|
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 |
---|---|
Convertit un objet d' CRegKey à un HKEY. |
|
Opérateur d'assignation |
Données membres publiques
Nom |
Description |
---|---|
Contient un handle de la clé de Registre associé à l'objet d' CRegKey . |
|
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