Globale Server-Registrierungs-Funktionen
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.