Classe CAtlComModule

Questa classe implementa un modulo server COM.

Sintassi

class CAtlComModule : public _ATL_COM_MODULE

Membri

Costruttori pubblici

Nome	Descrizione
CAtlComModule::CAtlComModule	Costruttore.
CAtlComModule::~CAtlComModule	Distruttore.

Metodi pubblici

Nome	Descrizione
CAtlComModule::RegisterServer	Chiamare questo metodo per aggiornare il Registro di sistema per ogni oggetto nella mappa oggetti.
CAtlComModule::RegisterTypeLib	Chiamare questo metodo per registrare una libreria dei tipi.
CAtlComModule::UnregisterServer	Chiamare questo metodo per annullare la registrazione di ogni oggetto nella mappa oggetti.
CAtlComModule::UnRegisterTypeLib	Chiamare questo metodo per annullare la registrazione di una libreria dei tipi.

Osservazioni:

CAtlComModule implementa un modulo server COM, consentendo a un client di accedere ai componenti del modulo.

Questa classe sostituisce la classe CComModule obsoleta usata nelle versioni precedenti di ATL. Per altri dettagli, vedere Classi di moduli ATL.

Gerarchia di ereditarietà

_ATL_COM_MODULE

CAtlComModule

Requisiti

Intestazione: atlbase.h

CAtlComModule::CAtlComModule

Costruttore.

CAtlComModule() throw();

Osservazioni:

Inizializza il modulo.

CAtlComModule::~CAtlComModule

Distruttore.

~CAtlComModule();

Osservazioni:

Libera tutte le class factory.

CAtlComModule::RegisterServer

Chiamare questo metodo per aggiornare il Registro di sistema per ogni oggetto nella mappa oggetti.

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

Parametri

bRegTypeLib
TRUE se la libreria dei tipi deve essere registrata. Il valore predefinito è FALSE.

pCLSID
Punta al CLSID dell'oggetto da registrare. Se NULL (valore predefinito), verranno registrati tutti gli oggetti nella mappa oggetti.

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

Osservazioni:

Chiama la funzione globale AtlComModuleRegisterServer.

CAtlComModule::RegisterTypeLib

Chiamare questo metodo per registrare una libreria dei tipi.

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

Parametri

lpszIndex
Stringa nel formato "\\N", dove N è l'indice intero della risorsa TYPELIB.

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

Osservazioni:

Aggiunge informazioni su una libreria dei tipi al Registro di sistema. Se l'istanza del modulo contiene più librerie dei tipi, usare la prima versione di questo metodo per specificare la libreria dei tipi da usare.

CAtlComModule::UnregisterServer

Chiamare questo metodo per annullare la registrazione di ogni oggetto nella mappa oggetti.

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

Parametri

bRegTypeLib
TRUE se la libreria dei tipi deve essere annullata. Il valore predefinito è FALSE.

pCLSID
Punta al CLSID dell'oggetto da annullare. Se NULL (valore predefinito), tutti gli oggetti nella mappa oggetti verranno annullati.

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

Osservazioni:

Chiama la funzione globale AtlComModuleUnregisterServer.

CAtlComModule::UnRegisterTypeLib

Chiamare questo metodo per annullare la registrazione di una libreria dei tipi.

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

Parametri

lpszIndex
Stringa nel formato "\\N", dove N è l'indice intero della risorsa TYPELIB.

Osservazioni:

Rimuove le informazioni su una libreria dei tipi dal Registro di sistema. Se l'istanza del modulo contiene più librerie dei tipi, usare la prima versione di questo metodo per specificare la libreria dei tipi da usare.

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

Vedi anche

_ATL_COM_MODULE
Cenni preliminari sulla classe