CAtlDllModuleT-klasse

Opmerking

De ATL (Active Template Library) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Deze klasse vertegenwoordigt de module voor een DLL.

Syntaxis

template <class T>
class ATL_NO_VTABLE CAtlDllModuleT : public CAtlModuleT<T>

Parameterwaarden

T
Uw klasse is afgeleid van CAtlDllModuleT.

Leden

Openbare constructors

Naam	Description
CAtlDllModuleT::CAtlDllModuleT	De constructor.
CAtlDllModuleT::~CAtlDllModuleT	De destructor.

Openbare methoden

Naam	Description
CAtlDllModuleT::D llCanUnloadNow	Test of het DLL-bestand kan worden uitgepakt.
CAtlDllModuleT::D llGetClassObject	Hiermee wordt een klassefactory geretourneerd.
CAtlDllModuleT::D llMain	Het optionele toegangspunt in een DLL (Dynamic Link Library).
CAtlDllModuleT::D llRegisterServer	Voegt vermeldingen toe aan het systeemregister voor objecten in het DLL-bestand.
CAtlDllModuleT::D llUnregisterServer	Hiermee verwijdert u vermeldingen in het systeemregister voor objecten in het DLL-bestand.
CAtlDllModuleT::GetClassObject	Hiermee wordt een klassefactory geretourneerd. Aangeroepen door DllGetClassObject.

Opmerkingen

CAtlDllModuleT vertegenwoordigt de module voor een DLL (Dynamic Link Library) en biedt functies die door alle DLL-projecten worden gebruikt. Deze specialisatie van de CAtlModuleT-klasse bevat ondersteuning voor registratie.

Zie ATL-moduleklassen voor meer informatie over modules in ATL.

Overnamehiërarchie

_ATL_MODULE

CAtlModule

CAtlModuleT

CAtlDllModuleT

Requirements

Header: atlbase.h

CAtlDllModuleT::CAtlDllModuleT

De constructor.

CAtlDllModuleT() throw();

CAtlDllModuleT::~CAtlDllModuleT

De destructor.

~CAtlDllModuleT() throw();

CAtlDllModuleT::D llCanUnloadNow

Test of het DLL-bestand kan worden uitgepakt.

HRESULT DllCanUnloadNow() throw();

Retourwaarde

Retourneert S_OK als het DLL-bestand kan worden uitgepakt of S_FALSE als dit niet mogelijk is.

CAtlDllModuleT::D llGetClassObject

Retourneert de klassefactory.

HRESULT DllGetClassObject(
    REFCLSID rclsid,
    REFIID riid,
    LPVOID* ppv) throw();

Parameterwaarden

rclsid
De CLSID van het object dat moet worden gemaakt.

riid
De IID van de aangevraagde interface.

Ppv
Een aanwijzer naar de interfacepointer die wordt geïdentificeerd door riid. Als het object deze interface niet ondersteunt, is PPV ingesteld op NULL.

Retourwaarde

Retourneert S_OK bij succes of een fout HRESULT bij fout.

CAtlDllModuleT::D llMain

Het optionele toegangspunt in een DLL (Dynamic Link Library).

BOOL WINAPI DllMain(DWORD dwReason, LPVOID /* lpReserved*/) throw();

Parameterwaarden

dwReason
Als deze optie is ingesteld op DLL_PROCESS_ATTACH, worden de DLL_THREAD_ATTACH en DLL_THREAD_DETACH meldingsoproepen uitgeschakeld.

lpReserved
Gereserveerd.

Retourwaarde

Retourneert altijd WAAR.

Opmerkingen

Het uitschakelen van de DLL_THREAD_ATTACH en DLL_THREAD_DETACH meldingsaanroepen kan een handige optimalisatie zijn voor toepassingen met meerdere threads met veel DLL's, die regelmatig threads maken en verwijderen, en waarvan dll's deze meldingen op threadniveau van bijlage/ontkoppeling niet nodig hebben.

CAtlDllModuleT::D llRegisterServer

Voegt vermeldingen toe aan het systeemregister voor objecten in het DLL-bestand.

HRESULT DllRegisterServer(BOOL bRegTypeLib = TRUE) throw();

Parameterwaarden

bRegTypeLib
WAAR als de typebibliotheek moet worden geregistreerd. De standaardwaarde is TRUE.

Retourwaarde

Retourneert S_OK bij succes of een fout HRESULT bij fout.

CAtlDllModuleT::D llUnregisterServer

Hiermee verwijdert u vermeldingen in het systeemregister voor objecten in het DLL-bestand.

HRESULT DllUnregisterServer(BOOL bUnRegTypeLib = TRUE) throw();

Parameterwaarden

bUnRegTypeLib
WAAR als de typebibliotheek uit het register moet worden verwijderd. De standaardwaarde is TRUE.

Retourwaarde

Retourneert S_OK bij succes of een fout HRESULT bij fout.

CAtlDllModuleT::GetClassObject

Hiermee maakt u een object van de opgegeven CLSID.

HRESULT GetClassObject(
    REFCLSID rclsid,
    REFIID riid,
    LPVOID* ppv) throw();

Parameterwaarden

rclsid
De CLSID van het object dat moet worden gemaakt.

riid
De IID van de aangevraagde interface.

Ppv
Een aanwijzer naar de interfacepointer die wordt geïdentificeerd door riid. Als het object deze interface niet ondersteunt, is PPV ingesteld op NULL.

Retourwaarde

Retourneert S_OK bij succes of een fout HRESULT bij fout.

Opmerkingen

Deze methode wordt aangeroepen door CAtlDllModuleT::D llGetClassObject en is opgenomen voor achterwaartse compatibiliteit.

Zie ook

CAtlModuleT-klasse
CAtlExeModuleT-klasse
Overzicht van klassen
Moduleklassen