CAtlComModule-Klasse

  • Artikel

Diese Klasse implementiert ein COM-Servermodul.

Syntax

class CAtlComModule : public _ATL_COM_MODULE

Member

Öffentliche Konstruktoren

Name Beschreibung
CAtlComModule::CAtlComModule Der Konstruktor.
CAtlComModule::~CAtlComModule Der Destruktor.

Öffentliche Methoden

Name Beschreibung
CAtlComModule::RegisterServer Rufen Sie diese Methode auf, um die Systemregistrierung für jedes Objekt in der Objektzuordnung zu aktualisieren.
CAtlComModule::RegisterTypeLib Rufen Sie diese Methode auf, um eine Typbibliothek zu registrieren.
CAtlComModule::UnregisterServer Rufen Sie diese Methode auf, um die Registrierung der einzelnen Objekte in der Objektzuordnung aufzuheben.
CAtlComModule::UnRegisterTypeLib Rufen Sie diese Methode auf, um die Registrierung einer Typbibliothek aufzuheben.

Hinweise

CAtlComModule implementiert ein COM-Servermodul, sodass ein Client auf die Komponenten des Moduls zugreifen kann.

Diese Klasse ersetzt die veraltete CComModule-Klasse , die in früheren Versionen von ATL verwendet wird. Weitere Informationen finden Sie unter ATL-Modulklassen .

Vererbungshierarchie

_ATL_COM_MODULE

CAtlComModule

Anforderungen

Kopfzeile: atlbase.h

CAtlComModule::CAtlComModule

Der Konstruktor.

CAtlComModule() throw();

Hinweise

Initialisiert das Modul.

CAtlComModule::~CAtlComModule

Der Destruktor.

~CAtlComModule();

Hinweise

Gibt alle Klassenfabriken frei.

CAtlComModule::RegisterServer

Rufen Sie diese Methode auf, um die Systemregistrierung für jedes Objekt in der Objektzuordnung zu aktualisieren.

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

Parameter

bRegTypeLib
TRUE, wenn die Typbibliothek registriert werden soll. Der Standardwert ist FALSCH.

pCLSID
Verweist auf die CLSID des zu registrierenden Objekts. Wenn NULL (Standardwert) alle Objekte in der Objektzuordnung registriert werden.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

Hinweise

Ruft die globale Funktion AtlComModuleRegisterServer auf.

CAtlComModule::RegisterTypeLib

Rufen Sie diese Methode auf, um eine Typbibliothek zu registrieren.

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

Parameter

lpszIndex
Zeichenfolge im Format "\\N", wobei N der ganzzahlige Index der TYPELIB-Ressource ist.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

Hinweise

Fügt der Systemregistrierung Informationen zu einer Typbibliothek hinzu. Wenn die Modulinstanz mehrere Typbibliotheken enthält, verwenden Sie die erste Version dieser Methode, um anzugeben, welche Typbibliothek verwendet werden soll.

CAtlComModule::UnregisterServer

Rufen Sie diese Methode auf, um die Registrierung der einzelnen Objekte in der Objektzuordnung aufzuheben.

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

Parameter

bRegTypeLib
TRUE, wenn die Typbibliothek nicht registriert werden soll. Der Standardwert ist FALSCH.

pCLSID
Verweist auf die CLSID des Objekts, das nicht registriert werden soll. Wenn NULL (Standardwert) alle Objekte in der Objektzuordnung nicht registriert werden.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

Hinweise

Ruft die globale Funktion AtlComModuleUnregisterServer auf.

CAtlComModule::UnRegisterTypeLib

Rufen Sie diese Methode auf, um die Registrierung einer Typbibliothek aufzuheben.

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

Parameter

lpszIndex
Zeichenfolge im Format "\\N", wobei N der ganzzahlige Index der TYPELIB-Ressource ist.

Hinweise

Entfernt Informationen zu einer Typbibliothek aus der Systemregistrierung. Wenn die Modulinstanz mehrere Typbibliotheken enthält, verwenden Sie die erste Version dieser Methode, um anzugeben, welche Typbibliothek verwendet werden soll.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

Siehe auch

_ATL_COM_MODULE
Klassenübersicht