CAtlComModule, classe

Cette classe implémente un module de serveur COM.

Syntaxe

class CAtlComModule : public _ATL_COM_MODULE

Membres

Constructeurs publics

Nom	Description
CAtlComModule ::CAtlComModule	Constructeur .
CAtlComModule ::~CAtlComModule	Destructeur.

Méthodes publiques

Nom	Description
CAtlComModule ::RegisterServer	Appelez cette méthode pour mettre à jour le registre système de chaque objet dans le mappage d’objets.
CAtlComModule ::RegisterTypeLib	Appelez cette méthode pour inscrire une bibliothèque de types.
CAtlComModule ::UnregisterServer	Appelez cette méthode pour annuler l’inscription de chaque objet dans le mappage d’objets.
CAtlComModule ::UnRegisterTypeLib	Appelez cette méthode pour annuler l’inscription d’une bibliothèque de types.

Notes

CAtlComModule implémente un module de serveur COM, ce qui permet à un client d’accéder aux composants du module.

Cette classe remplace la classe CComModule obsolète utilisée dans les versions antérieures d’ATL. Pour plus d’informations, consultez les classes de module ATL.

Hiérarchie d'héritage

_ATL_COM_MODULE

CAtlComModule

Spécifications

En-tête : atlbase.h

CAtlComModule ::CAtlComModule

Constructeur .

CAtlComModule() throw();

Notes

Initialise le module.

CAtlComModule ::~CAtlComModule

Destructeur.

~CAtlComModule();

Notes

Libère toutes les usines de classe.

CAtlComModule ::RegisterServer

Appelez cette méthode pour mettre à jour le registre système de chaque objet dans le mappage d’objets.

HRESULT RegisterServer(BOOL bRegTypeLib = FALSE, const CLSID* pCLSID = NULL);

Paramètres

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

pCLSID
Pointe vers le CLSID de l’objet à inscrire. Si la valeur null (valeur par défaut), tous les objets du mappage d’objets sont inscrits.

Valeur de retour

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

Notes

Appelle la fonction globale AtlComModuleRegisterServer.

CAtlComModule ::RegisterTypeLib

Appelez cette méthode pour inscrire une bibliothèque de types.

HRESULT RegisterTypeLib(LPCTSTR lpszIndex);
HRESULT RegisterTypeLib();

Paramètres

lpszIndex
Chaîne au format « \\N », où N est l’index entier de la ressource TYPELIB.

Valeur de retour

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

Notes

Ajoute des informations sur une bibliothèque de types au registre système. Si l’instance de module contient plusieurs bibliothèques de types, utilisez la première version de cette méthode pour spécifier la bibliothèque de types à utiliser.

CAtlComModule ::UnregisterServer

Appelez cette méthode pour annuler l’inscription de chaque objet dans le mappage d’objets.

HRESULT UnregisterServer(
    BOOL bRegTypeLib = FALSE,
    const CLSID* pCLSID = NULL);

Paramètres

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

pCLSID
Pointe vers le CLSID de l’objet à désinscrire. Si la valeur NULL (valeur par défaut), tous les objets de la carte d’objets ne sont pas inscrits.

Valeur de retour

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

Notes

Appelle la fonction globale AtlComModuleUnregisterServer.

CAtlComModule ::UnRegisterTypeLib

Appelez cette méthode pour annuler l’inscription d’une bibliothèque de types.

HRESULT UnRegisterTypeLib(LPCTSTR lpszIndex);
HRESULT UnRegisterTypeLib();

Paramètres

lpszIndex
Chaîne au format « \\N », où N est l’index entier de la ressource TYPELIB.

Notes

Supprime des informations sur une bibliothèque de types du registre système. Si l’instance de module contient plusieurs bibliothèques de types, utilisez la première version de cette méthode pour spécifier la bibliothèque de types à utiliser.

Valeur de retour

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

Voir aussi

_ATL_COM_MODULE
Vue d’ensemble de la classe