Класс КсеттингсстореспCSettingsStoreSP Class

CSettingsStoreSPКласс является вспомогательным классом, который можно использовать для создания экземпляров класса ксеттингссторе.The CSettingsStoreSP class is a helper class that you can use to create instances of the CSettingsStore Class.

СинтаксисSyntax

class CSettingsStoreSP

ЧленыMembers

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

nameName ОписаниеDescription
Ксеттингссторесп:: КсеттингсстореспCSettingsStoreSP::CSettingsStoreSP Формирует объект CSettingsStoreSP.Constructs a CSettingsStoreSP object.

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

nameName ОписаниеDescription
Ксеттингссторесп:: CreateCSettingsStoreSP::Create Создает экземпляр класса, производного от CSettingsStore .Creates an instance of a class that is derived from CSettingsStore.
Ксеттингссторесп:: СетрунтимеклассCSettingsStoreSP::SetRuntimeClass Задает класс среды выполнения.Sets the runtime class. CreateМетод использует класс среды выполнения, чтобы определить, какой класс объектов следует создать.The Create method uses the runtime class to determine what class of objects to create.

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

ИмяName ОписаниеDescription
m_dwUserData Пользовательские данные пользователя, хранящиеся в CSettingsStoreSP объекте.Custom user data that is stored in the CSettingsStoreSP object. Эти данные указываются в конструкторе CSettingsStoreSP объекта.You supply this data in the constructor of the CSettingsStoreSP object.
m_pRegistry CSettingsStoreОбъект, производный от, который Create создается методом.The CSettingsStore-derived object that the Create method creates.

КомментарииRemarks

Класс можно использовать CSettingsStoreSP для перенаправления всех операций реестра MFC в другие расположения, такие как XML-файл или база данных.You can use the CSettingsStoreSP class to redirect all MFC registry operations to other locations, such as an XML file or a database. Для этого выполните следующие действия:To do this, follow these steps:

  1. Создайте класс (например, CMyStore ) и наследует его от CSettingsStore .Create a class (such as CMyStore) and derive it from CSettingsStore.

  2. Используйте DECLARE_DYNCREATE и IMPLEMENT_DYNCREATE макросы с пользовательским CSettingsStore классом, чтобы включить динамическое создание.Use DECLARE_DYNCREATE and IMPLEMENT_DYNCREATE macros with your custom CSettingsStore class to enable dynamic creation.

  3. Переопределите виртуальные функции и реализуйте Read Write функции и в пользовательском классе.Override the virtual functions and implement the Read and Write functions in your custom class. Реализуйте любые другие функции для чтения и записи данных в нужное расположение.Implement any other functionality to read and write data to your desired location.

  4. В приложении вызовите CSettingsStoreSP::SetRuntimeClass и передайте указатель на структуру крунтимекласс , полученную из класса.In your application, call CSettingsStoreSP::SetRuntimeClass and pass in a pointer to the CRuntimeClass Structure obtained from your class.

Когда платформа обычно обращается к реестру, она теперь динамически создает пользовательский класс и использует его для чтения или записи данных.Whenever the framework would typically access the registry, it will now dynamically instantiate your custom class and use it to read or write data.

CSettingsStoreSP::SetRuntimeClass использует глобальную статическую переменную.CSettingsStoreSP::SetRuntimeClass uses a global static variable. Поэтому в каждый момент времени доступно только одно пользовательское хранилище.Therefore, only one custom store is available at a time.

ТребованияRequirements

Заголовок: афкссеттингссторе. hHeader: afxsettingsstore.h

Ксеттингссторесп:: CreateCSettingsStoreSP::Create

Создает новый экземпляр объекта, производного от класса ксеттингссторе.Creates a new instance of an object that is derived from the CSettingsStore Class.

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

ПараметрыParameters

бадминbAdmin
окне Логический параметр, определяющий, CSettingsStore создается ли объект в режиме администратора.[in] A Boolean parameter that determines whether a CSettingsStore object is created in administrator mode.

бреадонлиbReadOnly
окне Логический параметр, определяющий, CSettingsStore создан ли объект для доступа только для чтения.[in] A Boolean parameter that determines whether a CSettingsStore object is created for read-only access.

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

Ссылка на только что созданный CSettingsStore объект.A reference to the newly created CSettingsStore object.

КомментарииRemarks

Чтобы определить, какой тип объекта будет создан, можно использовать метод ксеттингссторесп:: сетрунтимекласс CSettingsStoreSP::Create .You can use the method CSettingsStoreSP::SetRuntimeClass to determine what type of object CSettingsStoreSP::Create will create. По умолчанию этот метод создает CSettingsStore объект.By default, this method creates a CSettingsStore object.

При создании CSettingsStore объекта в режиме администратора расположением по умолчанию для всех систем доступа к реестру является HKEY_LOCAL_MACHINE.If you create a CSettingsStore object in administrator mode, the default location for all registry access is HKEY_LOCAL_MACHINE. В противном случае расположением по умолчанию для всех обращений к реестру является HKEY_CURRENT_USER.Otherwise, the default location for all registry access is HKEY_CURRENT_USER.

Если бадмин имеет значение true, приложение должно иметь права администратора.If bAdmin is TRUE, the application must have administration rights. В противном случае произойдет сбой при попытке доступа к реестру.Otherwise, it will fail when it tries to access the registry.

ПримерExample

В следующем примере показано, как использовать Create метод CSettingsStoreSP класса.The following example demonstrates how to use the Create method of the CSettingsStoreSP class.

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

Ксеттингссторесп:: КсеттингсстореспCSettingsStoreSP::CSettingsStoreSP

Конструирует объект класса ксеттингссторесп .Constructs a CSettingsStoreSP Class object.

CSettingsStoreSP::CSettingsStoreSP(DWORD dwUserData = 0);

ПараметрыParameters

двусердатаdwUserData
окне Определяемые пользователем данные, которые CSettingsStoreSP хранятся в объекте.[in] User-defined data that the CSettingsStoreSP object stores.

КомментарииRemarks

CSettingsStoreSPОбъект сохраняет данные из двусердата в защищенной переменной члена m_dwUserData .The CSettingsStoreSP object stores the data from dwUserData in the protected member variable m_dwUserData.

Ксеттингссторесп:: СетрунтимеклассCSettingsStoreSP::SetRuntimeClass

Задает класс среды выполнения.Sets the runtime class. Метод ксеттингссторесп:: Create использует класс среды выполнения для определения типа создаваемого объекта.The method CSettingsStoreSP::Create uses the runtime class to determine what type of object to create.

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

ПараметрыParameters

пртиpRTI
окне Указатель на сведения о классе среды выполнения для класса, производного от класса ксеттингссторе.[in] A pointer to the runtime class information for a class derived from the CSettingsStore Class.

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

Значение TRUE в случае успешного выполнения; Значение FALSE, если класс, идентифицируемый прти , не является производным от CSettingsStore .TRUE if successful; FALSE if the class identified by pRTI is not derived from CSettingsStore.

КомментарииRemarks

Класс ксеттингссторесп можно использовать для наследования классов от CSettingsStore .You can use the CSettingsStoreSP Class to derive classes from CSettingsStore. Используйте метод, SetRuntimeClass Если требуется создать объекты пользовательского класса, производного от CSettingsStore .Use the method SetRuntimeClass if you want to create objects of a custom class that is derived from CSettingsStore.

См. также разделSee also

КлассыClasses
Иерархическая диаграммаHierarchy Chart
Класс КсеттингсстореCSettingsStore Class