Share via


CSettingsStoreSP-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

De CSettingsStoreSP klasse is een helperklasse die u kunt gebruiken om exemplaren van de CSettingsStore-klasse te maken.

Syntaxis

class CSettingsStoreSP

Leden

Openbare constructors

Naam Description
CSettingsStoreSP::CSettingsStoreSP Maakt een CSettingsStoreSP object.

Openbare methoden

Naam Description
CSettingsStoreSP::Maken Hiermee maakt u een exemplaar van een klasse die is afgeleid van CSettingsStore.
CSettingsStoreSP::SetRuntimeClass Hiermee stelt u de runtimeklasse in. De Create methode gebruikt de runtimeklasse om te bepalen welke klasse objecten moeten worden gemaakt.

Gegevensleden

Naam Description
m_dwUserData Aangepaste gebruikersgegevens die zijn opgeslagen in het CSettingsStoreSP object. U geeft deze gegevens op in de constructor van het CSettingsStoreSP object.
m_pRegistry Het CSettingsStore-afgeleide object dat door de Create methode wordt gemaakt.

Opmerkingen

U kunt de CSettingsStoreSP klasse gebruiken om alle MFC-registerbewerkingen om te leiden naar andere locaties, zoals een XML-bestand of een database. Volg hiervoor deze stappen:

  1. Maak een klasse (zoals CMyStore) en leid deze af van CSettingsStore.

  2. Gebruik DECLARE_DYNCREATE en IMPLEMENT_DYNCREATE macro's met uw aangepaste CSettingsStore klasse om dynamisch te maken.

  3. Overschrijf de virtuele functies en implementeer de Read en Write functies in uw aangepaste klasse. Implementeer alle andere functionaliteit voor het lezen en schrijven van gegevens naar de gewenste locatie.

  4. Roep in uw toepassing CSettingsStoreSP::SetRuntimeClass een aanwijzer aan en geef deze door aan de CRuntimeClass-structuur die u hebt verkregen van uw klas.

Wanneer het framework doorgaans toegang heeft tot het register, wordt uw aangepaste klasse dynamisch geïnstitueerd en gebruikt om gegevens te lezen of te schrijven.

CSettingsStoreSP::SetRuntimeClass maakt gebruik van een globale statische variabele. Daarom is er slechts één aangepaste winkel tegelijk beschikbaar.

Requirements

Koptekst: afxsettingsstore.h

CSettingsStoreSP::Maken

Hiermee maakt u een nieuw exemplaar van een object dat is afgeleid van de CSettingsStore-klasse.

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

Parameterwaarden

bAdmin
[in] Een Booleaanse parameter die bepaalt of een CSettingsStore object wordt gemaakt in de beheerdersmodus.

bReadOnly
[in] Een Booleaanse parameter die bepaalt of een CSettingsStore object wordt gemaakt voor alleen-lezentoegang.

Retourwaarde

Een verwijzing naar het zojuist gemaakte CSettingsStore object.

Opmerkingen

U kunt de methode CSettingsStoreSP::SetRuntimeClass gebruiken om te bepalen welk type object CSettingsStoreSP::Create wordt gemaakt. Met deze methode wordt standaard een CSettingsStore object gemaakt.

Als u een CSettingsStore object maakt in de beheerdersmodus, wordt de standaardlocatie voor alle registertoegang HKEY_LOCAL_MACHINE. Anders is de standaardlocatie voor alle registertoegang HKEY_CURRENT_USER.

Als bAdmin TRUE is, moet de toepassing beheerdersrechten hebben. Anders mislukt het wanneer er wordt geprobeerd toegang te krijgen tot het register.

Example

In het volgende voorbeeld ziet u hoe u de Create methode van de CSettingsStoreSP klasse gebruikt.

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

CSettingsStoreSP::CSettingsStoreSP

Bouwt een CSettingsStoreSP-klasseobject .

CSettingsStoreSP::CSettingsStoreSP(DWORD dwUserData = 0);

Parameterwaarden

dwUserData
[in] Door de gebruiker gedefinieerde gegevens die door het CSettingsStoreSP object worden opgeslagen.

Opmerkingen

Het CSettingsStoreSP object slaat de gegevens van dwUserData op in de beveiligde lidvariabele m_dwUserData.

CSettingsStoreSP::SetRuntimeClass

Hiermee stelt u de runtimeklasse in. De methode CSettingsStoreSP::Create maakt gebruik van de runtimeklasse om te bepalen welk type object moet worden gemaakt.

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

Parameterwaarden

pRTI
[in] Een aanwijzer naar de runtimeklasse-informatie voor een klasse die is afgeleid van de CSettingsStore-klasse.

Retourwaarde

WAAR indien geslaagd; ONWAAR als de door pRTI geïdentificeerde klasse niet is afgeleid van CSettingsStore.

Opmerkingen

U kunt de CSettingsStoreSP-klasse gebruiken om klassen af te leiden van CSettingsStore. Gebruik de methode SetRuntimeClass als u objecten wilt maken van een aangepaste klasse die is afgeleid van CSettingsStore.

Zie ook

Klassen
Hiërarchiegrafiek
CSettingsStore-klasse