Partager via


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

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

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 en cas de 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 en cas de 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 en cas de 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 en cas de 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