Funciones globales de registro del servidor

Estas funciones proporcionan compatibilidad con el registro y la anulación del registro de objetos del servidor en el mapa de objetos.

Importante

Las funciones enumeradas en la tabla siguiente no se pueden usar en las aplicaciones que se ejecutan en Windows Runtime.

Nombre	Descripción
AtlComModuleRegisterServer	Esta función se invoca para registrar todos los objetos del mapa de objetos.
AtlComModuleUnregisterServer	Esta función se invoca para anular el registro de todos los objetos del mapa de objetos.
AtlComModuleRegisterClassObjects	Esta función se invoca para registrar los objetos de clase.
AtlComModuleRevokeClassObjects	Esta función se invoca para revocar los objetos de clase de un módulo COM.
AtlComModuleGetClassObject	Esta función se invoca para obtener el objeto de clase.

Requisitos

Encabezado: atlbase.h

AtlComModuleRegisterServer

Esta función se invoca para registrar todos los objetos del mapa de objetos.

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

Parámetros

pComModule
Puntero al módulo COM.

bRegTypeLib
TRUE si se va a registrar la biblioteca de tipos.

pCLSID
Apunta al CLSID del objeto que se va a registrar. Si es NULL, todos los objetos se registrarán en el mapa de objetos.

Valor devuelto

Devuelve S_OK si es correcto o un error HRESULT en caso de error.

Comentarios

AtlComModuleRegisterServer recorre el mapa de objetos generado automáticamente por ATL y registra cada objeto en el mapa. Si pCLSID no es NULL, solo se registra el objeto al que hace referencia pCLSID ; de lo contrario, se registran todos los objetos.

Esta función es invocada por CAtlComModule::RegisterServer.

AtlComModuleUnregisterServer

Esta función se invoca para anular el registro de todos los objetos del mapa de objetos.

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

Parámetros

pComModule
Puntero al módulo COM.

bUnRegTypeLib
TRUE si se va a registrar la biblioteca de tipos.

pCLSID
Apunta al CLSID del objeto del que se va a anular el registro. Si es NULL, se anulará el registro de todos los objetos del mapa de objetos.

Valor devuelto

Devuelve S_OK si es correcto o un error HRESULT en caso de error.

Comentarios

AtlComModuleUnregisterServer recorre el mapa de objetos ATL y anula el registro de cada objeto en el mapa. Si pCLSID no es NULL, solo se anula el registro del objeto al que hace referencia pCLSID; de lo contrario, se anula el registro de todos los objetos.

Esta función es invocada por CAtlComModule::UnregisterServer.

AtlComModuleRegisterClassObjects

Esta función se invoca para registrar los objetos de clase.

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

Parámetros

pComModule
Puntero al módulo COM.

dwClsContext
Especifica el contexto en el que se va a ejecutar el objeto de clase. Los valores posibles son CLSCTX_INPROC_SERVER, CLSCTX_INPROC_HANDLER o CLSCTX_LOCAL_SERVER. Vea CLSCTX para obtener más información.

dwFlags
Determina los tipos de conexión al objeto de clase. Los valores posibles son REGCLS_SINGLEUSE, REGCLS_MULTIPLEUSE, o REGCLS_MULTI_SEPARATE. Vea REGCLS para obtener más información.

Valor devuelto

Devuelve S_OK si es correcto o un error HRESULT en caso de error.

Comentarios

Esta función del asistente es usada por CComModule::RegisterClassObjects (obsoleta en ATL 7.0) y CAtlExeModuleT::RegisterClassObjects.

AtlComModuleRevokeClassObjects

Esta función se invoca para quitar el generador o generadores de clases de la tabla de objetos en ejecución.

ATLINLINE ATLAPI AtlComModuleRevokeClassObjects(_ATL_COM_MODULE* pComModule);

Parámetros

pComModule
Puntero al módulo COM.

Valor devuelto

Devuelve S_OK si es correcto o un error HRESULT en caso de error.

Comentarios

Esta función del asistente es usada por CComModule::RevokeClassObjects (obsoleta en ATL 7.0) y CAtlExeModuleT::RevokeClassObjects.

AtlComModuleGetClassObject

Esta función se invoca para devolver el generador de clases.

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

Parámetros

pComModule
Puntero al módulo COM.

rclsid
El CLSID del objeto que se va a crear.

riid
El IID de la interfaz solicitada.

ppv
Puntero al puntero de interfaz identificado por riid. Si el objeto no admite esta interfaz, ppv se establece como NULL.

Valor devuelto

Devuelve S_OK si es correcto o un error HRESULT en caso de error.

Comentarios

Esta función de asistente es usada por CComModule::GetClassObject (obsoleta en ATL 7.0) y CAtlDllModuleT::GetClassObject.

Consulte también

Funciones