Fonctions globales d’inscription de serveur
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.