CAtlDllModuleT, classe

Cette classe représente le module d’une DLL.

Syntaxe

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

Paramètres

T
Votre classe dérivée de CAtlDllModuleT.

Membres

Constructeurs publics

Nom	Description
CAtlDllModuleT ::CAtlDllModuleT	Constructeur .
CAtlDllModuleT ::~CAtlDllModuleT	Destructeur.

Méthodes publiques

Nom	Description
CAtlDllModuleT ::D llCanUnloadNow	Teste si la DLL peut être déchargée.
CAtlDllModuleT ::D llGetClassObject	Retourne une fabrique de classes.
CAtlDllModuleT ::D llMain	Point d’entrée facultatif dans une bibliothèque de liens dynamiques (DLL).
CAtlDllModuleT ::D llRegisterServer	Ajoute des entrées au registre système pour les objets dans la DLL.
CAtlDllModuleT ::D llUnregisterServer	Supprime les entrées dans le registre système pour les objets de la DLL.
CAtlDllModuleT ::GetClassObject	Retourne une fabrique de classes. Appelé par DllGetClassObject.

Notes

CAtlDllModuleT représente le module d’une bibliothèque de liens dynamiques (DLL) et fournit des fonctions utilisées par tous les projets DLL. Cette spécialisation de la classe CAtlModuleT inclut la prise en charge de l’inscription.

Pour plus d’informations sur les modules dans ATL, consultez les classes de module ATL.

Hiérarchie d'héritage

_ATL_MODULE

CAtlModule

CAtlModuleT

CAtlDllModuleT

Spécifications

En-tête : atlbase.h

CAtlDllModuleT ::CAtlDllModuleT

Constructeur .

CAtlDllModuleT() throw();

CAtlDllModuleT ::~CAtlDllModuleT

Destructeur.

~CAtlDllModuleT() throw();

CAtlDllModuleT ::D llCanUnloadNow

Teste si la DLL peut être déchargée.

HRESULT DllCanUnloadNow() throw();

Valeur de retour

Retourne S_OK si la DLL peut être déchargée ou S_FALSE si elle ne peut pas.

CAtlDllModuleT ::D llGetClassObject

Retourne la fabrique de classes.

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

Paramètres

rclsid
CLSID de l’objet à créer.

riid
IID de l’interface demandée.

Ppv
Pointeur vers le pointeur d’interface identifié par riid. Si l’objet ne prend pas en charge cette interface, ppv est défini sur NULL.

Valeur de retour

Retourne S_OK sur la réussite ou une erreur HRESULT en cas d’échec.

CAtlDllModuleT ::D llMain

Point d’entrée facultatif dans une bibliothèque de liens dynamiques (DLL).

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

Paramètres

dwReason
Si la valeur est DLL_PROCESS_ATTACH, les appels de notification DLL_THREAD_ATTACH et DLL_THREAD_DETACH sont désactivés.

lpReserved
Réservé.

Valeur de retour

Retourne toujours TRUE.

Notes

La désactivation des appels de notification DLL_THREAD_ATTACH et DLL_THREAD_DETACH peut être une optimisation utile pour les applications multithreads qui ont de nombreuses DLL, qui créent et suppriment fréquemment des threads et dont les DLL n’ont pas besoin de ces notifications au niveau du thread de la pièce jointe/détachement.

CAtlDllModuleT ::D llRegisterServer

Ajoute des entrées au registre système pour les objets dans la DLL.

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

Paramètres

bRegTypeLib
TRUE si la bibliothèque de types doit être inscrite. La valeur par défaut est TRUE.

Valeur de retour

Retourne S_OK sur la réussite ou une erreur HRESULT en cas d’échec.

CAtlDllModuleT ::D llUnregisterServer

Supprime les entrées dans le registre système pour les objets de la DLL.

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

Paramètres

bUnRegTypeLib
TRUE si la bibliothèque de types doit être supprimée du Registre. La valeur par défaut est TRUE.

Valeur de retour

Retourne S_OK sur la réussite ou une erreur HRESULT en cas d’échec.

CAtlDllModuleT ::GetClassObject

Crée un objet du CLSID spécifié.

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

Paramètres

rclsid
CLSID de l’objet à créer.

riid
IID de l’interface demandée.

Ppv
Pointeur vers le pointeur d’interface identifié par riid. Si l’objet ne prend pas en charge cette interface, ppv est défini sur NULL.

Valeur de retour

Retourne S_OK sur la réussite ou une erreur HRESULT en cas d’échec.

Notes

Cette méthode est appelée par CAtlDllModuleT ::D llGetClassObject et est incluse pour la compatibilité descendante.

Voir aussi

CAtlModuleT, classe
CAtlExeModuleT, classe
Vue d’ensemble de la classe
Module Classes