Partager via

Fonctions globales d’inscription de serveur

  • Article

Ces fonctions prennent en charge l’inscription et l’annulation de l’inscription d’objets serveur dans le mappage d’objets.

Important

Les fonctions répertoriées dans le tableau suivant ne peuvent pas être utilisées dans les applications qui s’exécutent dans Windows Runtime.

Nom Description
AtlComModuleRegisterServer Cette fonction est appelée pour inscrire chaque objet du mappage d'objets.
AtlComModuleUnregisterServer Cette fonction est appelée pour annuler l'inscription de chaque objet du mappage d'objets.
AtlComModuleRegisterClassObjects Cette fonction est appelée pour inscrire des objets de classe.
AtlComModuleRevokeClassObjects Cette fonction est appelée pour révoquer des objets de classe d’un module COM.
AtlComModuleGetClassObject Cette fonction est appelée pour obtenir l’objet de classe.

Spécifications

En-tête : atlbase.h

AtlComModuleRegisterServer

Cette fonction est appelée pour inscrire chaque objet du mappage d'objets.

ATLINLINE ATLAPI AtlComModuleRegisterServer(
    _ATL_COM_MODULE* pComModule,
    BOOL bRegTypeLib,
    const CLSID* pCLSID);

Paramètres

pComModule
Pointeur vers le module COM.

bRegTypeLib
TRUE si la bibliothèque de types doit être inscrite.

pCLSID
Pointe vers le CLSID de l’objet à inscrire. Si la valeur est NULL, tous les objets de la carte d’objets sont inscrits.

Valeur de retour

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

Notes

AtlComModuleRegisterServer guide le mappage d’objets généré automatiquement par ATL et inscrit chaque objet dans la carte. Si pCLSID n’est pas NULL, seul l’objet référencé par pCLSID est inscrit ; sinon, tous les objets sont inscrits.

Cette fonction est appelée par CAtlComModule ::RegisterServer.

AtlComModuleUnregisterServer

Cette fonction est appelée pour annuler l'inscription de chaque objet du mappage d'objets.

ATLINLINE ATLAPI AtlComModuleUnregisterServer(
    _ATL_COM_MODULE* pComModule,
    BOOL bUnRegTypeLib,
    const CLSID* pCLSID);

Paramètres

pComModule
Pointeur vers le module COM.

bUnRegTypeLib
TRUE si la bibliothèque de types doit être inscrite.

pCLSID
Pointe vers le CLSID de l’objet à désinscrire. Si tous les objets de la carte d’objets ne sont pas enregistrés, la valeur NULL est annulée.

Valeur de retour

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

Notes

AtlComModuleUnregisterServer guide le mappage d’objets ATL et annule l’inscription de chaque objet dans la carte. Si pCLSID n’est pas NULL, seul l’objet référencé par pCLSID n’est pas inscrit ; sinon, tous les objets ne sont pas inscrits.

Cette fonction est appelée par CAtlComModule ::UnregisterServer.

AtlComModuleRegisterClassObjects

Cette fonction est appelée pour inscrire des objets de classe.

ATLINLINE ATLAPI AtlComModuleRegisterClassObjects(
    _ATL_COM_MODULE* pComModule,
    DWORD dwClsContext,
    DWORD dwFlags);

Paramètres

pComModule
Pointeur vers le module COM.

dwClsContext
Spécifie le contexte dans lequel l’objet de classe doit être exécuté. Les valeurs possibles sont CLSCTX_INPROC_SERVER, CLSCTX_INPROC_HANDLER ou CLSCTX_LOCAL_SERVER. Pour plus d’informations, consultez CLSCTX .

dwFlags
Détermine les types de connexion à l’objet de classe. Les valeurs possibles sont REGCLS_SINGLEUSE, REGCLS_MULTIPLEUSE ou REGCLS_MULTI_SEPARATE. Pour plus d’informations, consultez REGCLS .

Valeur de retour

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

Notes

Cette fonction d’assistance est utilisée par CComModule ::RegisterClassObjects (obsolète dans ATL 7.0) et CAtlExeModuleT ::RegisterClassObjects.

AtlComModuleRevokeClassObjects

Cette fonction est appelée pour supprimer la ou les fabriques de classes de la table des objets en cours d'exécution (ROT).

ATLINLINE ATLAPI AtlComModuleRevokeClassObjects(_ATL_COM_MODULE* pComModule);

Paramètres

pComModule
Pointeur vers le module COM.

Valeur de retour

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

Notes

Cette fonction d’assistance est utilisée par CComModule ::RevokeClassObjects (obsolète dans ATL 7.0) et CAtlExeModuleT ::RevokeClassObjects.

AtlComModuleGetClassObject

Cette fonction est appelée pour retourner la fabrique de classe.

ATLINLINE ATLAPI AtlComModuleGetClassObject(
    _ATL_COM_MODULE* pComModule,
    REFCLSID rclsid,
    REFIID riid,
    LPVOID* ppv);

Paramètres

pComModule
Pointeur vers le module COM.

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 fonction d’assistance est utilisée par CComModule ::GetClassObject (obsolète dans ATL 7.0) et CAtlDllModuleT ::GetClassObject.

Voir aussi

Fonctions