Compartilhar via

Funções globais de registro de servidor

  • Artigo

Fornecer suporte para registrar e cancelar o registro de objetos de servidor no mapa do objeto.

Importante

As funções listadas na tabela a seguir não podem ser usadas em aplicativos que são executados no Windows Runtime.

Nome Descrição
AtlComModuleRegisterServer Essa função é chamada para registrar cada objeto no mapa de objetos.
AtlComModuleUnregisterServer Essa função é chamada para cancelar o registro de cada objeto no mapa de objetos.
AtlComModuleRegisterClassObjects Essa função é chamada para registrar objetos da classe.
AtlComModuleRevokeClassObjects Essa função é chamada para revogar objetos de classe de um módulo COM.
AtlComModuleGetClassObject Essa função é chamada para obter o objeto de classe.

Requisitos

Cabeçalho: atlbase.h

AtlComModuleRegisterServer

Essa função é chamada para registrar cada objeto no mapa de objetos.

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

Parâmetros

pComModule
Ponteiro para o módulo COM.

bRegTypeLib
TRUE se a biblioteca de tipos deve ser registrada.

pCLSID
Aponta para o CLSID do objeto a ser registrado. Se NULL, todos os objetos no mapa de objetos serão registrados.

Valor de retorno

Retornará S_OK se houver êxito ou um erro HRESULT, em caso de falha.

Comentários

AtlComModuleRegisterServer percorre o mapa de objeto gerado automaticamente da ATL e registra cada objeto no mapa. Se pCLSID não for NULL, somente o objeto referenciado por pCLSID será registrado; caso contrário, todos os objetos são registrados.

Essa função é chamada por CAtlComModule::RegisterServer.

AtlComModuleUnregisterServer

Essa função é chamada para cancelar o registro de cada objeto no mapa de objetos.

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

Parâmetros

pComModule
Ponteiro para o módulo COM.

bUnRegTypeLib
TRUE se a biblioteca de tipos deve ser registrada.

pCLSID
Aponta para o CLSID do objeto a ser cancelado. Se NULL, todos os objetos no mapa de objetos terão o registro cancelado.

Valor de retorno

Retornará S_OK se houver êxito ou um erro HRESULT, em caso de falha.

Comentários

AtlComModuleUnregisterServer percorre o mapa do objeto ATL e cancela o registro de cada objeto no mapa. Se pCLSID não for NULL, somente o objeto referenciado por pCLSID terá o registro cancelado; caso contrário, todos os objetos terão o registro cancelado.

Essa função é chamada por CAtlComModule::RegisterServer.

AtlComModuleRegisterClassObjects

Essa função é chamada para registrar objetos da classe.

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

Parâmetros

pComModule
Ponteiro para o módulo COM.

dwClsContext
Especifica o contexto no qual o objeto de classe deve ser executado. Os valores possíveis são CLSCTX_INPROC_SERVER, CLSCTX_INPROC_HANDLER ou CLSCTX_LOCAL_SERVER. Consulte CLSCTX para obter mais detalhes.

dwFlags
Determina os tipos de conexão com o objeto de classe. Os valores possíveis são REGCLS_SINGLEUSE, REGCLS_MULTIPLEUSE ou REGCLS_MULTI_SEPARATE. Consulte REGCLS para obter mais detalhes.

Valor de retorno

Retornará S_OK se houver êxito ou um erro HRESULT, em caso de falha.

Comentários

Essa função auxiliar é utilizada por CComModule::RegisterClassObjects (obsoleto no ATL 7.0) e CAtlExeModuleT::RegisterClassObjects.

AtlComModuleRevokeClassObjects

Essa função é chamada para remover a fábrica/as fábricas da classe da Tabela de Objetos em Execução.

ATLINLINE ATLAPI AtlComModuleRevokeClassObjects(_ATL_COM_MODULE* pComModule);

Parâmetros

pComModule
Ponteiro para o módulo COM.

Valor de retorno

Retornará S_OK se houver êxito ou um erro HRESULT, em caso de falha.

Comentários

Essa função auxiliar é utilizada por CComModule::RevokeClassObjects (obsoleto no ATL 7.0) e CAtlExeModuleT::RevokeClassObjects.

AtlComModuleGetClassObject

Essa função é chamada para retornar a fábrica da classe.

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

Parâmetros

pComModule
Ponteiro para o módulo COM.

rclsid
O CLSID do objeto a ser criado.

riid
O IID da interface solicitada.

ppv
Um ponteiro para o ponteiro da interface identificado por riid. Se o objeto não der suporte a essa interface, o ppv será definido como NULL.

Valor de retorno

Retornará S_OK se houver êxito ou um erro HRESULT, em caso de falha.

Comentários

Essa função auxiliar é utilizada por CComModule::GetClassObject (obsoleto no ATL 7.0) e CAtlDllModuleT::GetClassObject.

Confira também

Funções