Класс CSettingsStoreSP

  • Статья

Класс CSettingsStoreSP является вспомогательным классом, который можно использовать для создания экземпляров класса C Параметры Store.

Синтаксис

class CSettingsStoreSP

Участники

Открытые конструкторы

Имя Описание
C Параметры StoreSP::C Параметры StoreSP Формирует объект CSettingsStoreSP.

Открытые методы

Имя Описание
C Параметры StoreSP::Create Создает экземпляр класса, производный от CSettingsStore.
C Параметры StoreSP::SetRuntimeClass Задает класс среды выполнения. Метод Create использует класс среды выполнения для определения того, какой класс объектов нужно создать.

Элементы данных

Имя Описание
m_dwUserData Пользовательские данные пользователя, хранящиеся в объекте CSettingsStoreSP . Эти данные предоставляются в конструкторе CSettingsStoreSP объекта.
m_pRegistry Производный CSettingsStoreот метода объект Create .

Замечания

Класс можно использовать CSettingsStoreSP для перенаправления всех операций реестра MFC в другие расположения, например XML-файл или базу данных. Для этого выполните следующие шаги.

  1. Создайте класс (напримерCMyStore) и наследуйте его.CSettingsStore

  2. Используйте макросы DECLARE_DYNCREATE и IMPLEMENT_DYNCREATE с пользовательским CSettingsStore классом, чтобы включить динамическое создание.

  3. Переопределите виртуальные функции и реализуйте ReadWrite их в пользовательском классе. Реализуйте любые другие функции для чтения и записи данных в нужное расположение.

  4. В приложении вызовите и передайте CSettingsStoreSP::SetRuntimeClass указатель на структуру CRuntimeClass, полученную из класса.

Каждый раз, когда платформа будет получать доступ к реестру, теперь она будет динамически создавать экземпляр пользовательского класса и использовать его для чтения или записи данных.

CSettingsStoreSP::SetRuntimeClass использует глобальную статическую переменную. Поэтому одновременно доступно только одно пользовательское хранилище.

Требования

Заголовок: afxsettingsstore.h

C Параметры StoreSP::Create

Создает новый экземпляр объекта, производный от класса C Параметры Store.

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

Параметры

b Администратор
[in] Логический параметр, определяющий, создается ли CSettingsStore объект в режиме администратора.

bReadOnly
[in] Логический параметр, определяющий, создается ли CSettingsStore объект для доступа только для чтения.

Возвращаемое значение

Ссылка на только что созданный CSettingsStore объект.

Замечания

Метод C Параметры StoreSP::SetRuntimeClass можно использовать для определения типа создаваемого объектаCSettingsStoreSP::Create. По умолчанию этот метод создает CSettingsStore объект.

Если вы создаете CSettingsStore объект в режиме администратора, расположение по умолчанию для всех доступа к реестру HKEY_LOCAL_MACHINE. В противном случае расположение по умолчанию для всех доступа к реестру HKEY_CURRENT_USER.

Если параметр b Администратор имеет значение TRUE, приложение должно иметь права администрирования. В противном случае он завершится ошибкой при попытке получить доступ к реестру.

Пример

В следующем примере показано, как использовать Create метод CSettingsStoreSP класса.

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

C Параметры StoreSP::C Параметры StoreSP

Создает объект класса C Параметры StoreSP.

CSettingsStoreSP::CSettingsStoreSP(DWORD dwUserData = 0);

Параметры

dwUserData
[in] Определяемые пользователем CSettingsStoreSP данные, которые хранит объект.

Замечания

Объект CSettingsStoreSP сохраняет данные из dwUserData в защищенной переменной-члене m_dwUserData.

C Параметры StoreSP::SetRuntimeClass

Задает класс среды выполнения. Метод C Параметры StoreSP::Create использует класс среды выполнения для определения типа создаваемого объекта.

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

Параметры

pRTI
[in] Указатель на сведения о классе среды выполнения для класса, производного от класса C Параметры Store.

Возвращаемое значение

Значение TRUE, если выполнено успешно; ЗНАЧЕНИЕ FALSE, если класс, определенный pRTI, не является производным от CSettingsStore.

Замечания

Класс C Параметры StoreSP можно использовать для получения классов.CSettingsStore Используйте метод SetRuntimeClass , если вы хотите создать объекты пользовательского класса, производного от CSettingsStore.

См. также

Классы
Диаграмма иерархии
Класс CSettingsStore