(연관된 글이 1개 있습니다.)
그냥 알아만 두고 넘어간 사실이었는 데, 최근에 필요하게 되어서 좀 살펴봤습니다. ^^
원하는 것은, ATL 프로젝트에 포함된 *.rgs 파일에 제가 원하는 변수를 추가하는 것입니다. 런타임시에 결정되는 값이므로, 그렇게 구현해야 했습니다. 물론, 이런 방식이 아니고도, DllRegisterServer API에서 _AtlModule.DllRegisterServer(); 실행 이후에 원하는 레지스트리 설정 작업을 해줄 수도 있습니다.
그래도 좀 ^^ 멋있는 방법을 쓰는 것이 좋지 않겠습니까!
일단, MSDN Library에는 다음과 같은 토픽으로 그 기능을 설명하고 있습니다.
ATL Library Reference
Using Replaceable Parameters (The Registrar's Preprocessor)
;
https://docs.microsoft.com/en-us/cpp/atl/using-replaceable-parameters-the-registrar-s-preprocessor
문제는, 해당 토픽이 최근의 VC++ 버전에 맞게 업데이트 되지 않았다는 것입니다.
대강 살펴보면, 기본 등록 코드를 작성해주는 매크로인 DECLARE_REGISTRY_RESOURCEID를 제거하고, 함수를 사용자 정의 하라는 것입니다. 물론, 그렇게 하면 되겠지만, 사용자 정의 함수에는 기존 함수의 모든 코드를 그대로 받아서 처리해야 하는 번거로움이 있습니다.
VC++ 8.0에서, 어느 정도 번거로운지 대강 살펴보겠습니다.
매크로 함수인 DECLARE_REGISTRY_RESOURCEID를 없애고, 해당 함수를 직접 재정의하려면, 프로젝트의 ATL Control 클래스 선언 안에서 다음과 같은 함수를 정의해 주어야 합니다.
static HRESULT WINAPI UpdateRegistry(BOOL bRegister) throw()
{
__if_exists(_GetMiscStatus)
{
/* 중간 생략 */
__if_exists(_Module)
{
return _Module.UpdateRegistryFromResource(x, bRegister, regMapEntries);
}
__if_not_exists(_Module)
{
return ATL::_pAtlModule->UpdateRegistryFromResource(x, bRegister, regMapEntries);
}
}
__if_not_exists(_GetMiscStatus)
{
__if_exists(_Module)
{
return _Module.UpdateRegistryFromResource(x, bRegister);
}
__if_not_exists(_Module)
{
return ATL::_pAtlModule->UpdateRegistryFromResource(x, bRegister);
}
}
}
다시 보니, 이건 해답이 아닙니다. 결국 재정의 해야 하는 대상은 UpdateRegistry 함수가 아니고, UpdateRegistryFromResource 함수입니다. 이 함수는 매크로로 정의되어 있고, _ATL_STATIC_REGSTRY 매크로 변수의 유무에 따라 다음과 같은 2가지 함수로 나뉩니다.
UpdateRegistryFromResourceS
UpdateRegistryFromResourceD
결국, 위의 2가지 함수를 재정의해야 됩니다. 위의 함수들은 CAtlModule과 CComModule에 정의되어 있지만, ATL이 생성해 주는 Module 클래스의 부모는 CAtlModule이므로, 그 클래스의 함수를 재정의해야 합니다.
모듈 클래스는 ATL 프로젝트 생성시 기본 생성되는 .cpp 파일에 다음과 같은 형식으로 포함되어 있습니다.
class CMyModule : public CAtlDllModuleT< CDxDocsViewerModule >
{
public :
DECLARE_LIBID(LIBID_CMyModuleLib)
DECLARE_REGISTRY_APPID_RESOURCEID(IDR_CMYMODULE, "{1D60CA78-9AB6-44E0-8FBE-4053B9F15A29}")
};
위의 클래스 정의에
HRESULT WINAPI UpdateRegistryFromResourceS(LPCTSTR lpszRes, BOOL bRegister,
struct _ATL_REGMAP_ENTRY* pMapEntries = NULL) throw();
HRESULT WINAPI UpdateRegistryFromResourceS(UINT nResID, BOOL bRegister,
struct _ATL_REGMAP_ENTRY* pMapEntries = NULL) throw();
HRESULT WINAPI UpdateRegistryFromResourceD(LPCTSTR lpszRes, BOOL bRegister,
struct _ATL_REGMAP_ENTRY* pMapEntries = NULL) throw();
HRESULT WINAPI UpdateRegistryFromResourceD(UINT nResID, BOOL bRegister,
struct _ATL_REGMAP_ENTRY* pMapEntries = NULL) throw();
의 4개 함수를 재정의 해주어야 합니다. (물론, 경우의 수가 고정이 된다면 메서드 하나만 재정의하는 것으로 끝날 수 있습니다.) 역시, 그다지 좋은 방법은 아닌 듯 싶습니다.
결국, MSDN 문서대로 진행한다면 위와 같은 결론에 이르게 되는데요.
VC++ 8.0(7.0 에서도 그런지는 모르겠지만.)에서 제공되는 ATL은 사용자 정의 전처리기 파라미터를 제공하기 위해 다른 방식을 제공해 주고 있습니다. 물론, 이 부분이 문서화가 되어 있지 않아서 문제이긴 하지만.
방법은, 위의 새로 추가될 4개의 함수에 대한 소스를 살펴보시면 알게 됩니다.
가만히 보시면,
virtual HRESULT AddCommonRGSReplacements(IRegistrarBase* /*pRegistrar*/) throw() = 0;
해당 함수들은 모두 위의 가상 함수를 호출하는 것을 볼수가 있습니다. (이름 자체에서 태생을 짐작케 만듭니다.)
이제 쉽게 문제가 해결되었습니다. 결국, Module 클래스에 다음과 같이 함수를 재정의하면 되는 것입니다.
class CMyModule : public CAtlDllModuleT< CDxDocsViewerModule >
{
public :
DECLARE_LIBID(LIBID_CMyModuleLib)
DECLARE_REGISTRY_APPID_RESOURCEID(IDR_CMYMODULE, "{1D60CA78-9AB6-44E0-8FBE-4053B9F15A29}")
virtual HRESULT AddCommonRGSReplacements( IRegistrarBase* pRegistrar )
{
return pRegistrar->AddReplacement( L"MYVAR", L"TEST" );
}
};
그런데, 이게 왠 일입니까? 위와 같이 하면, 컴파일 후 자동 등록되는 과정에서 오류가 발생하고 맙니다. ^^;
도대체 뭐가 잘못된 것일까요? 엉뚱하게도 저는 이 해답을 일본어로 된 토픽에서 찾을 수 있었습니다.
http://www.ailight.jp/blog/sha256/archive/2006/01/28/11027.aspx
MFC 에서 그렇게 많이 보아왔던, 부모 클래스에서 정의한 함수를 자식 클래스에서 재정의한 함수에서 호출해 주는 것을 사용해야 했던 것입니다. virtual로 인해, CAtlDllModuleT를 포함해서 부모클래스들에서 정의된 AddCommonRGSReplacement 안의 모든 변수들이 추가되지 않기 때문에 발생하는 것이었습니다.
이런 경우, MFC에서처럼 부모 클래스명과 함께 해당 메서드를 명시적으로 실행해 주는 방법이 있고, 위의 토픽에서 보는 것처럼 __super 키워드를 쓰는 것도 좋은 방법입니다. 따라서, 최종 코드는 다음과 같습니다.
class CMyModule : public CAtlDllModuleT< CDxDocsViewerModule >
{
public :
DECLARE_LIBID(LIBID_CMyModuleLib)
DECLARE_REGISTRY_APPID_RESOURCEID(IDR_CMYMODULE, "{1D60CA78-9AB6-44E0-8FBE-4053B9F15A29}")
virtual HRESULT AddCommonRGSReplacements( IRegistrarBase* pRegistrar )
{
HRESULT hr = pRegistrar->AddReplacement( L"MYVAR", L"TEST" );
if ( FAILED( hr ) ) return hr;
return __super::AddCommonRGSReplacements( pRegistrar );
}
};
[연관 글]