CAtlModule 클래스

이 클래스는 여러 ATL 모듈 클래스에서 사용하는 메서드를 제공합니다.

구문

class ATL_NO_VTABLE CAtlModule : public _ATL_MODULE

멤버

공용 생성자

속성	설명
CAtlModule::CAtlModule	생성자입니다.
CAtlModule::~CAtlModule	소멸자입니다.

공용 메서드

이름	설명
CAtlModule::AddCommonRGSReplacements	이 메서드를 재정의하여 ATL 레지스트리 구성 요소(등록자) 대체 맵에 매개 변수를 추가합니다.
CAtlModule::AddTermFunc	모듈이 종료될 때 호출할 새 함수를 추가합니다.
CAtlModule::GetGITPtr	전역 인터페이스 포인터를 반환합니다.
CAtlModule::GetLockCount	잠금 수를 반환합니다.
CAtlModule::Lock	잠금 수를 증분합니다.
CAtlModule::Term	모든 데이터 멤버를 해제합니다.
CAtlModule::Unlock	잠금 수를 줄입니다.
CAtlModule::UpdateRegistryFromResourceD	지정된 리소스에 포함된 스크립트를 실행하여 개체를 등록하거나 등록 취소합니다.
CAtlModule::UpdateRegistryFromResourceDHelper	이 메서드는 레지스트리 업데이트를 수행 하기 위해 호출 UpdateRegistryFromResourceD 합니다.
CAtlModule::UpdateRegistryFromResourceS	지정된 리소스에 포함된 스크립트를 실행하여 개체를 등록하거나 등록 취소합니다. 이 메서드는 ATL 레지스트리 구성 요소에 정적으로 연결됩니다.

공용 데이터 멤버

속성	설명
CAtlModule::m_libid	현재 모듈의 GUID를 포함합니다.
CAtlModule::m_pGIT	전역 인터페이스 테이블에 대한 포인터입니다.

설명

이 클래스는 CAtlDllModuleT 클래스, CAtlExeModuleT 클래스 및 CAtlServiceModuleT 클래스에서 각각 DLL 애플리케이션, EXE 애플리케이션 및 Windows 서비스를 지원하는 데 사용됩니다.

ATL의 모듈에 대한 자세한 내용은 ATL 모듈 클래스를 참조 하세요.

이 클래스는 이전 버전의 ATL에서 사용된 사용되지 않는 CComModule 클래스 를 대체합니다.

상속 계층 구조

_ATL_MODULE

CAtlModule

요구 사항

헤더: atlbase.h

CAtlModule::AddCommonRGSReplacements

이 메서드를 재정의하여 ATL 레지스트리 구성 요소(등록자) 대체 맵에 매개 변수를 추가합니다.

virtual HRESULT AddCommonRGSReplacements(IRegistrarBase* /* pRegistrar*/) throw() = 0;

매개 변수

pRegistrar
예약되었습니다.

Return Value

성공 시 S_OK를 반환하거나 실패 시 HRESULT 오류를 반환합니다.

설명

대체 가능한 매개 변수를 사용하면 등록자의 클라이언트에서 런타임 데이터를 지정할 수 있습니다. 이를 위해 등록 기관은 스크립트에서 대체 가능한 매개 변수와 연결된 값을 입력하는 대체 맵을 유지 관리합니다. 등록 기관은 런타임에 이러한 항목을 만듭니다.

자세한 내용은 대체 가능한 매개 변수 사용 항목 (등록 기관의 전처리기) 을 참조하세요.

CAtlModule::AddTermFunc

모듈이 종료될 때 호출할 새 함수를 추가합니다.

HRESULT AddTermFunc(_ATL_TERMFUNC* pFunc, DWORD_PTR dw) throw();

매개 변수

pFunc
추가할 함수에 대한 포인터입니다.

dw
함수에 전달된 사용자 정의 데이터입니다.

Return Value

성공 시 S_OK를 반환하거나 실패 시 HRESULT 오류를 반환합니다.

CAtlModule::CAtlModule

생성자입니다.

CAtlModule() throw();

설명

데이터 멤버를 초기화하고 모듈의 스레드 주위에 중요한 섹션을 시작합니다.

CAtlModule::~CAtlModule

소멸자입니다.

~CAtlModule() throw();

설명

모든 데이터 멤버를 해제합니다.

CAtlModule::GetGITPtr

전역 인터페이스 테이블에 대한 포인터를 검색합니다.

virtual HRESULT GetGITPtr(IGlobalInterfaceTable** ppGIT) throw();

매개 변수

ppGIT
전역 인터페이스 테이블에 대한 포인터를 받을 변수에 대한 포인터입니다.

Return Value

성공에 대한 S_OK 반환하거나 실패에 대한 오류 코드를 반환합니다. ppGIT가 NULL과 같으면 E_POINTER 반환됩니다.

설명

Global Interface Table 개체가 없으면 생성되고 해당 주소는 CAtlModule::m_pGIT 멤버 변수에 저장됩니다.

디버그 빌드에서 ppGIT가 NULL과 같거나 전역 인터페이스 테이블 포인터를 가져올 수 없는 경우 어설션 오류가 발생합니다.

전역 인터페이스 테이블에 대한 자세한 내용은 IGlobalInterfaceTable을 참조하세요.

CAtlModule::GetLockCount

잠금 수를 반환합니다.

virtual LONG GetLockCount() throw();

Return Value

잠금 수를 반환합니다. 이 값은 진단 및 디버깅에 유용할 수 있습니다.

CAtlModule::Lock

잠금 수를 증분합니다.

virtual LONG Lock() throw();

Return Value

잠금 수를 증가시키고 업데이트된 값을 반환합니다. 이 값은 진단 및 디버깅에 유용할 수 있습니다.

CAtlModule::m_libid

현재 모듈의 GUID를 포함합니다.

static GUID m_libid;

CAtlModule::m_pGIT

전역 인터페이스 테이블에 대한 포인터입니다.

IGlobalInterfaceTable* m_pGIT;

CAtlModule::Term

모든 데이터 멤버를 해제합니다.

void Term() throw();

설명

모든 데이터 멤버를 해제합니다. 이 메서드는 소멸자가 호출합니다.

CAtlModule::Unlock

잠금 수를 줄입니다.

virtual LONG Unlock() throw();

Return Value

잠금 수를 감소시키고 업데이트된 값을 반환합니다. 이 값은 진단 및 디버깅에 유용할 수 있습니다.

CAtlModule::UpdateRegistryFromResourceD

지정된 리소스에 포함된 스크립트를 실행하여 개체를 등록하거나 등록 취소합니다.

HRESULT WINAPI UpdateRegistryFromResourceD(
    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();

매개 변수

lpszRes
리소스 이름입니다.

nResID
리소스 ID입니다.

bRegister
개체를 등록해야 하는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

pMapEntries
스크립트의 대체 가능한 매개 변수와 연결된 값을 저장하는 대체 맵에 대한 포인터입니다. ATL은 자동으로 %MODULE%을(를) 사용합니다. 대체 가능한 매개 변수 를 추가로 사용하려면 CAtlModule::AddCommonRGSReplacements를 참조하세요. 그렇지 않으면 NULL 기본값을 사용합니다.

Return Value

성공 시 S_OK를 반환하거나 실패 시 HRESULT 오류를 반환합니다.

설명

lpszRes 또는 nResID로 지정된 리소스에 포함된 스크립트를 실행합니다. bRegister가 TRUE이면 이 메서드는 시스템 레지스트리에 개체를 등록하고, 그렇지 않으면 레지스트리에서 개체를 제거합니다.

ATL 레지스트리 구성 요소(등록 기관)에 정적으로 연결하려면 CAtlModule::UpdateRegistryFromResourceS를 참조 하세요.

이 메서드는 CAtlModule::UpdateRegistryFromResourceDHelper 및 IRegistrar::ResourceUnregister를 호출합니다.

CAtlModule::UpdateRegistryFromResourceDHelper

이 메서드는 레지스트리 업데이트를 수행 하기 위해 호출 UpdateRegistryFromResourceD 합니다.

inline HRESULT WINAPI UpdateRegistryFromResourceDHelper(
    LPCOLESTR lpszRes,
    BOOL bRegister,
    struct _ATL_REGMAP_ENTRY* pMapEntries = NULL) throw();

매개 변수

lpszRes
리소스 이름입니다.

bRegister
개체를 등록해야 하는지 여부를 나타냅니다.

pMapEntries
스크립트의 대체 가능한 매개 변수와 연결된 값을 저장하는 대체 맵에 대한 포인터입니다. ATL은 자동으로 %MODULE%을(를) 사용합니다. 대체 가능한 매개 변수 를 추가로 사용하려면 CAtlModule::AddCommonRGSReplacements를 참조하세요. 그렇지 않으면 NULL 기본값을 사용합니다.

Return Value

성공 시 S_OK를 반환하거나 실패 시 HRESULT 오류를 반환합니다.

설명

이 메서드는 CAtlModule::UpdateRegistryFromResourceD의 구현을 제공합니다.

CAtlModule::UpdateRegistryFromResourceS

지정된 리소스에 포함된 스크립트를 실행하여 개체를 등록하거나 등록 취소합니다. 이 메서드는 ATL 레지스트리 구성 요소에 정적으로 연결됩니다.

HRESULT WINAPI UpdateRegistryFromResourceS(
    UINT nResID,
    BOOL bRegister,
    struct _ATL_REGMAP_ENTRY* pMapEntries = NULL) throw();

HRESULT WINAPI UpdateRegistryFromResourceS(
    LPCTSTR lpszRes,
    BOOL bRegister,
    struct _ATL_REGMAP_ENTRY* pMapEntries = NULL) throw();

매개 변수

nResID
리소스 ID입니다.

lpszRes
리소스 이름입니다.

bRegister
리소스 스크립트를 등록해야 하는지 여부를 나타냅니다.

pMapEntries
스크립트의 대체 가능한 매개 변수와 연결된 값을 저장하는 대체 맵에 대한 포인터입니다. ATL은 자동으로 %MODULE%을(를) 사용합니다. 대체 가능한 매개 변수 를 추가로 사용하려면 CAtlModule::AddCommonRGSReplacements를 참조하세요. 그렇지 않으면 NULL 기본값을 사용합니다.

Return Value

성공 시 S_OK를 반환하거나 실패 시 HRESULT 오류를 반환합니다.

설명

CAtlModule::UpdateRegistryFromResourceD와 비슷하지만 CAtlModule::UpdateRegistryFromResourceS ATL 레지스트리 구성 요소(등록 기관)에 대한 정적 링크를 만듭니다.

참고 항목

_ATL_MODULE
클래스 개요
모듈 클래스
레지스트리 구성 요소(등록자)