CSettingsStoreSP, classe

La CSettingsStoreSP classe est une classe d’assistance que vous pouvez utiliser pour créer des instances de la classe C Paramètres Store.

Syntaxe

class CSettingsStoreSP

Membres

Constructeurs publics

Nom	Description
C Paramètres StoreSP ::C Paramètres StoreSP	Construit un objet CSettingsStoreSP.

Méthodes publiques

Nom	Description
C Paramètres StoreSP ::Create	Crée une instance d’une classe dérivée de CSettingsStore.
C Paramètres StoreSP ::SetRuntimeClass	Définit la classe runtime. La Create méthode utilise la classe runtime pour déterminer la classe d’objets à créer.

Données membres

Nom	Description
m_dwUserData	Données utilisateur personnalisées stockées dans l’objet CSettingsStoreSP . Vous fournissez ces données dans le constructeur de l’objet CSettingsStoreSP .
m_pRegistry	Objet CSettingsStoredérivé créé par la Create méthode.

Notes

Vous pouvez utiliser la CSettingsStoreSP classe pour rediriger toutes les opérations de Registre MFC vers d’autres emplacements, tels qu’un fichier XML ou une base de données. Pour ce faire, procédez comme suit :

1. Créez une classe (par exemple CMyStore) et dérivez-la de CSettingsStore.

2. Utilisez DECLARE_DYNCREATE et IMPLEMENT_DYNCREATE macros avec votre classe personnalisée CSettingsStore pour activer la création dynamique.

3. Remplacez les fonctions virtuelles et implémentez les fonctions et Write les Read fonctions de votre classe personnalisée. Implémentez toute autre fonctionnalité permettant de lire et d’écrire des données à votre emplacement souhaité.

4. Dans votre application, appelez CSettingsStoreSP::SetRuntimeClass et transmettez un pointeur vers la structure CRuntimeClass obtenue à partir de votre classe.

Chaque fois que l’infrastructure accède généralement au Registre, elle instancie dynamiquement votre classe personnalisée et l’utilise pour lire ou écrire des données.

CSettingsStoreSP::SetRuntimeClass utilise une variable statique globale. Par conséquent, un seul magasin personnalisé est disponible à la fois.

Spécifications

En-tête : afxsettingsstore.h

C Paramètres StoreSP ::Create

Crée une instance d’un objet dérivé de la classe C Paramètres Store.

CSettingsStore& CSettingsStoreSP Create(
    BOOL bAdmin,
    BOOL bReadOnly);

Paramètres

b Administration
[in] Paramètre booléen qui détermine si un CSettingsStore objet est créé en mode administrateur.

bReadOnly
[in] Paramètre booléen qui détermine si un objet est créé pour un CSettingsStore accès en lecture seule.

Valeur de retour

Référence à l’objet nouvellement créé CSettingsStore .

Notes

Vous pouvez utiliser la méthode C Paramètres StoreSP ::SetRuntimeClass pour déterminer le type d’objet CSettingsStoreSP::Create créé. Par défaut, cette méthode crée un CSettingsStore objet.

Si vous créez un CSettingsStore objet en mode administrateur, l’emplacement par défaut de tous les accès au Registre est HKEY_LOCAL_MACHINE. Sinon, l’emplacement par défaut de tous les accès au Registre est HKEY_CURRENT_USER.

Si b Administration a la valeur TRUE, l’application doit avoir des droits d’administration. Sinon, il échoue lorsqu’il tente d’accéder au Registre.

Exemple

L’exemple suivant montre comment utiliser la Create méthode de la CSettingsStoreSP classe.

CSettingsStoreSP regSP;
CSettingsStore &reg = regSP.Create(FALSE, TRUE);

C Paramètres StoreSP ::C Paramètres StoreSP

Construit un objet C Paramètres StoreSP Class.

CSettingsStoreSP::CSettingsStoreSP(DWORD dwUserData = 0);

Paramètres

dwUserData
[in] Données définies par l’utilisateur que l’objet CSettingsStoreSP stocke.

Notes

L’objet CSettingsStoreSP stocke les données de dwUserData dans la variable m_dwUserDatamembre protégée.

C Paramètres StoreSP ::SetRuntimeClass

Définit la classe runtime. La méthode C Paramètres StoreSP ::Create utilise la classe runtime pour déterminer le type d’objet à créer.

static BOOL __stdcall CSettingsStoreSP::SetRuntimeClass(CRuntimeClass* pRTI);

Paramètres

pRTI
[in] Pointeur vers les informations de classe runtime pour une classe dérivée de la classe C Paramètres Store.

Valeur de retour

TRUE si elle réussit ; FALSE si la classe identifiée par pRTI n’est pas dérivée de CSettingsStore.

Notes

Vous pouvez utiliser la classe C Paramètres StoreSP pour dériver des classes à partir de CSettingsStore. Utilisez la méthode SetRuntimeClass si vous souhaitez créer des objets d’une classe personnalisée dérivée de CSettingsStore.

Voir aussi

Classes
Graphique hiérarchique
CSettingsStore, classe