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à
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.