Globale Server-Registrierungs-Funktionen

  • Artikel

Diese Funktionen unterstützen das Registrieren und Aufheben der Registrierung von Serverobjekten in der Objektzuordnung.

Wichtig

Die in der folgenden Tabelle aufgeführten Funktionen können nicht in Anwendungen verwendet werden, die in der Windows-Runtime ausgeführt werden.

Name Beschreibung
AtlComModuleRegisterServer Diese Funktion wird aufgerufen, um alle Objekte in der Objektzuordnung zu registrieren.
AtlComModuleUnregisterServer Diese Funktion wird aufgerufen, um die Registrierung aller Objekte in der Objektzuordnung aufzuheben.
AtlComModuleRegisterClassObjects Diese Funktion wird aufgerufen, um Klassenobjekte zu registrieren.
AtlComModuleRevokeClassObjects Diese Funktion wird aufgerufen, um Klassenobjekte aus einem COM-Modul zu widerrufen.
AtlComModuleGetClassObject Diese Funktion wird aufgerufen, um das Klassenobjekt abzurufen.

Anforderungen

Kopfzeile: atlbase.h

AtlComModuleRegisterServer

Diese Funktion wird aufgerufen, um alle Objekte in der Objektzuordnung zu registrieren.

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

Parameter

pComModule
Zeiger auf das COM-Modul.

bRegTypeLib
TRUE, wenn die Typbibliothek registriert werden soll.

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

Rückgabewert

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

Hinweise

AtlComModuleRegisterServer führt die automatisch generierte ATL-Objektzuordnung durch und registriert jedes Objekt in der Karte. Wenn pCLSID nicht NULL ist, wird nur das von pCLSID bezeichnete Objekt registriert. Andernfalls werden alle Objekte registriert.

Diese Funktion wird von CAtlComModule::RegisterServer aufgerufen.

AtlComModuleUnregisterServer

Diese Funktion wird aufgerufen, um die Registrierung aller Objekte in der Objektzuordnung aufzuheben.

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

Parameter

pComModule
Zeiger auf das COM-Modul.

bUnRegTypeLib
TRUE, wenn die Typbibliothek registriert werden soll.

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

Rückgabewert

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

Hinweise

AtlComModuleUnregisterServer führt die ATL-Objektzuordnung durch und hebt die Registrierung der einzelnen Objekte in der Karte auf. Wenn pCLSID nicht NULL ist, wird nur das von pCLSID referenzierte Objekt nicht registriert. Andernfalls werden alle Objekte nicht registriert.

Diese Funktion wird von CAtlComModule::UnregisterServer aufgerufen.

AtlComModuleRegisterClassObjects

Diese Funktion wird aufgerufen, um Klassenobjekte zu registrieren.

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

Parameter

pComModule
Zeiger auf das COM-Modul.

dwClsContext
Gibt den Kontext an, in dem das Klassenobjekt ausgeführt werden soll. Mögliche Werte sind CLSCTX_INPROC_SERVER, CLSCTX_INPROC_HANDLER oder CLSCTX_LOCAL_SERVER. Weitere Details finden Sie unter CLSCTX .

dwFlags
Bestimmt die Verbindungstypen mit dem Klassenobjekt. Mögliche Werte sind REGCLS_SINGLEUSE, REGCLS_MULTIPLEUSE oder REGCLS_MULTI_SEPARATE. Weitere Informationen finden Sie unter REGCLS .

Rückgabewert

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

Hinweise

Diese Hilfsfunktion wird von CComModule::RegisterClassObjects (veraltet in ATL 7.0) und CAtlExeModuleT::RegisterClassObjects verwendet.

AtlComModuleRevokeClassObjects

Diese Funktion wird aufgerufen, um eine oder mehrere Klassenfactorys aus der ROT (Running Object Table) zu entfernen.

ATLINLINE ATLAPI AtlComModuleRevokeClassObjects(_ATL_COM_MODULE* pComModule);

Parameter

pComModule
Zeiger auf das COM-Modul.

Rückgabewert

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

Hinweise

Diese Hilfsfunktion wird von CComModule::RevokeClassObjects (veraltet in ATL 7.0) und CAtlExeModuleT::RevokeClassObjects verwendet.

AtlComModuleGetClassObject

Diese Funktion wird aufgerufen, um die Klassenfactory zurückzugeben.

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

Parameter

pComModule
Zeiger auf das COM-Modul.

rclsid
Die CLSID des zu erstellenden Objekts.

riid
Die IID der angeforderten Schnittstelle.

ppv
Ein Zeiger auf den Schnittstellenzeiger, der von riid identifiziert wird. Wenn das Objekt diese Schnittstelle nicht unterstützt, wird ppv auf NULL festgelegt.

Rückgabewert

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

Hinweise

Diese Hilfsfunktion wird von CComModule::GetClassObject (veraltet in ATL 7.0) und CAtlDllModuleT::GetClassObject verwendet.

Siehe auch

Funktionen