세팅스토어SP 클래스CSettingsStoreSP Class

클래스는 CSettingsStoreSP CSettingsStore클래스의 인스턴스를 만드는 데 사용할 수 있는 도우미 클래스입니다.The CSettingsStoreSP class is a helper class that you can use to create instances of the CSettingsStore Class.

구문Syntax

class CSettingsStoreSP

멤버Members

Public 생성자Public Constructors

속성Name DescriptionDescription
설정스토어SP:::세팅스토어SPCSettingsStoreSP::CSettingsStoreSP CSettingsStoreSP 개체를 생성합니다.Constructs a CSettingsStoreSP object.

Public 메서드Public Methods

속성Name DescriptionDescription
설정저장소SP:만들기CSettingsStoreSP::Create CSettingsStore에서 파생 된 클래스의 인스턴스를 만듭니다.Creates an instance of a class that is derived from CSettingsStore.
설정저장소SP::셋런타임클래스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 DescriptionDescription
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 만드는 -derive된 개체입니다.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. 사용자 지정 IMPLEMENT_DYNCREATE CSettingsStore 클래스와 함께 DECLARE_DYNCREATE 및 IMPLEMENT_DYNCREATE 매크로를 사용하여 동적 생성을 활성화합니다.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 CRuntimeClass 구조에 대한 포인터를 호출하고 전달합니다.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

헤더: afxsettingsstore.hHeader: afxsettingsstore.h

설정저장소SP:만들기CSettingsStoreSP::Create

CSettingsStore 클래스에서파생 된 개체의 새 인스턴스를 만듭니다.Creates a new instance of an object that is derived from the CSettingsStore Class.

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

매개 변수Parameters

bAdminbAdmin
【인】 CSettingsStore 개체가 관리자 모드에서 생성되는지 여부를 결정하는 부울 매개 변수입니다.[in] A Boolean parameter that determines whether a CSettingsStore object is created in administrator mode.

bReadOnlybReadOnly
【인】 읽기 전용 액세스를 위해 개체가 CSettingsStore 만들어지는지 여부를 결정하는 부울 매개 변수입니다.[in] A Boolean parameter that determines whether a CSettingsStore object is created for read-only access.

Return ValueReturn Value

새로 생성된 CSettingsStore 개체에 대한 참조입니다.A reference to the newly created CSettingsStore object.

설명Remarks

CSettingsStoreSP::SetRuntimeClass 메서드를 사용하여 만들 개체 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.

bAdmin이 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);

설정스토어SP:::세팅스토어SPCSettingsStoreSP::CSettingsStoreSP

CSettingsStoreSP 클래스 개체를 생성합니다.Constructs a CSettingsStoreSP Class object.

CSettingsStoreSP::CSettingsStoreSP(DWORD dwUserData = 0);

매개 변수Parameters

dw사용자 데이터dwUserData
【인】 개체가 CSettingsStoreSP 저장하는 사용자 정의 데이터입니다.[in] User-defined data that the CSettingsStoreSP object stores.

설명Remarks

개체는 CSettingsStoreSP 보호된 멤버 변수에 m_dwUserData dwUserData의 데이터를 저장합니다.The CSettingsStoreSP object stores the data from dwUserData in the protected member variable m_dwUserData.

설정저장소SP::셋런타임클래스CSettingsStoreSP::SetRuntimeClass

런타임 클래스를 설정합니다.Sets the runtime class. CSettingsStoreSP: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

pRTIpRTI
【인】 CSettingsStore클래스에서 파생 된 클래스에 대 한 런타임 클래스 정보에 대 한 포인터입니다.[in] A pointer to the runtime class information for a class derived from the CSettingsStore Class.

Return ValueReturn Value

성공하면 TRUE; false pRTI로 식별된 클래스가 에서 CSettingsStore파생되지 않은 경우.TRUE if successful; FALSE if the class identified by pRTI is not derived from CSettingsStore.

설명Remarks

CSettingsStoreSP 클래스를 사용하여 에서 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 클래스CSettingsStore Class