Udostępnij za pośrednictwem

Klasa CSettingsStoreSP

  • Artykuł

Klasa CSettingsStoreSP jest klasą pomocnika, której można użyć do tworzenia wystąpień klasy CSettingsStore.

Składnia

class CSettingsStoreSP

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CSettingsStoreSP::CSettingsStoreSP CSettingsStoreSP Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko opis
CSettingsStoreSP::Create Tworzy wystąpienie klasy pochodzącej z CSettingsStoreklasy .
CSettingsStoreSP::SetRuntimeClass Ustawia klasę środowiska uruchomieniowego. Metoda Create używa klasy środowiska uruchomieniowego do określenia, jaka klasa obiektów ma zostać utworzona.

Składowe danych

Nazwa/nazwisko opis
m_dwUserData Niestandardowe dane użytkownika przechowywane w CSettingsStoreSP obiekcie. Te dane należy podać w konstruktorze CSettingsStoreSP obiektu.
m_pRegistry Obiekt CSettingsStorepochodny, który Create tworzy metoda.

Uwagi

Możesz użyć CSettingsStoreSP klasy , aby przekierować wszystkie operacje rejestru MFC do innych lokalizacji, takich jak plik XML lub baza danych. W tym celu wykonaj następujące kroki:

  1. Utwórz klasę (na przykład CMyStore) i utwórz ją z CSettingsStoreklasy .

  2. Użyj makr DECLARE_DYNCREATE i IMPLEMENT_DYNCREATE z klasą niestandardową CSettingsStore , aby umożliwić tworzenie dynamiczne.

  3. Zastąpij funkcje wirtualne i zaimplementuj Read funkcje i Write w klasie niestandardowej. Zaimplementuj wszelkie inne funkcje, aby odczytywać i zapisywać dane w żądanej lokalizacji.

  4. W aplikacji wywołaj CSettingsStoreSP::SetRuntimeClass wskaźnik i przekaż wskaźnik do struktury CRuntimeClass uzyskanej z klasy.

Zawsze, gdy platforma zwykle uzyskuje dostęp do rejestru, teraz dynamicznie tworzy wystąpienie klasy niestandardowej i używa jej do odczytywania lub zapisywania danych.

CSettingsStoreSP::SetRuntimeClass używa globalnej zmiennej statycznej. W związku z tym tylko jeden magazyn niestandardowy jest dostępny w danym momencie.

Wymagania

Nagłówek: afxsettingsstore.h

CSettingsStoreSP::Create

Tworzy nowe wystąpienie obiektu pochodzącego z klasy CSettingsStore.

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

Parametry

bAdmin
[in] Parametr logiczny określający, czy CSettingsStore obiekt jest tworzony w trybie administratora.

bReadOnly
[in] Parametr logiczny określający, czy CSettingsStore obiekt jest tworzony na potrzeby dostępu tylko do odczytu.

Wartość zwracana

Odwołanie do nowo utworzonego CSettingsStore obiektu.

Uwagi

Możesz użyć metody CSettingsStoreSP::SetRuntimeClass , aby określić, jaki typ obiektu CSettingsStoreSP::Create zostanie utworzony. Domyślnie ta metoda tworzy CSettingsStore obiekt.

Jeśli utworzysz obiekt w trybie administratora, domyślną lokalizacją CSettingsStore dla całego dostępu do rejestru jest HKEY_LOCAL_MACHINE. W przeciwnym razie domyślną lokalizacją dla całego dostępu do rejestru jest HKEY_CURRENT_USER.

Jeśli bAdmin ma wartość TRUE, aplikacja musi mieć uprawnienia administracyjne. W przeciwnym razie próba uzyskania dostępu do rejestru zakończy się niepowodzeniem.

Przykład

W poniższym przykładzie pokazano, jak używać Create metody CSettingsStoreSP klasy .

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

CSettingsStoreSP::CSettingsStoreSP

Tworzy obiekt klasy CSettingsStoreSP.

CSettingsStoreSP::CSettingsStoreSP(DWORD dwUserData = 0);

Parametry

dwUserData
[in] Zdefiniowane przez użytkownika dane przechowywane przez CSettingsStoreSP obiekt.

Uwagi

Obiekt CSettingsStoreSP przechowuje dane z dwUserData w chronionej zmiennej składowej m_dwUserData.

CSettingsStoreSP::SetRuntimeClass

Ustawia klasę środowiska uruchomieniowego. Metoda CSettingsStoreSP::Create używa klasy środowiska uruchomieniowego do określenia typu obiektu do utworzenia.

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

Parametry

pRTI
[in] Wskaźnik do informacji o klasie środowiska uruchomieniowego dla klasy pochodzącej z klasy CSettingsStore.

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; FALSE, jeśli klasa zidentyfikowana przez narzędzie pRTI nie pochodzi z klasy CSettingsStore.

Uwagi

Klasę CSettingsStoreSP można użyć do wyprowadzenia klas z CSettingsStoreklasy . Użyj metody SetRuntimeClass , jeśli chcesz utworzyć obiekty klasy niestandardowej pochodzącej z CSettingsStoreklasy .

Zobacz też

Klasy
Wykres hierarchii
Klasa CSettingsStore