CAtlBaseModule-Klasse
Diese Klasse wird in jedem ATL-Projekt instanziiert.
Syntax
class CAtlBaseModule : public _ATL_BASE_MODULE
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CAtlBaseModule::CAtlBaseModule | Der Konstruktor. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CAtlBaseModule::AddResourceInstance | Fügt der Liste der gespeicherten Handles eine Ressourceninstanz hinzu. |
| CAtlBaseModule::GetHInstanceAt | Gibt ein Handle an eine angegebene Ressourceninstanz zurück. |
| CAtlBaseModule::GetModuleInstance | Gibt die Modulinstanz aus einem CAtlBaseModule Objekt zurück. |
| CAtlBaseModule::GetResourceInstance | Gibt die Ressourceninstanz aus einem CAtlBaseModule Objekt zurück. |
| CAtlBaseModule::RemoveResourceInstance | Entfernt eine Ressourceninstanz aus der Liste der gespeicherten Handles. |
| CAtlBaseModule::SetResourceInstance | Legt die Ressourceninstanz eines CAtlBaseModule Objekts fest. |
Öffentliche Datenmember
| Name | Beschreibung |
|---|---|
| CAtlBaseModule::m_bInitFailed | Eine Variable, die angibt, ob die Modulinitialisierung fehlgeschlagen ist. |
Hinweise
Eine Instanz der CAtlBaseModule benannten _AtlBaseModule ist in jedem ATL-Projekt vorhanden, das ein Handle für die Modulinstanz enthält, ein Handle für das Modul, das Ressourcen enthält (die standardmäßig eins und dasselbe sind) und ein Array von Handles für Module, die primäre Ressourcen bereitstellen. CAtlBaseModule kann über mehrere Threads sicher zugegriffen werden.
Diese Klasse ersetzt die veraltete CComModule-Klasse , die in früheren Versionen von ATL verwendet wird.
Vererbungshierarchie
CAtlBaseModule
Anforderungen
Header: atlcore.h
CAtlBaseModule::AddResourceInstance
Fügt der Liste der gespeicherten Handles eine Ressourceninstanz hinzu.
bool AddResourceInstance(HINSTANCE hInst) throw();
Parameter
hInst
Die hinzuzufügende Ressourceninstanz.
Rückgabewert
Gibt "true" zurück, wenn die Ressource erfolgreich hinzugefügt wurde, andernfalls "false".
CAtlBaseModule::CAtlBaseModule
Der Konstruktor.
CAtlBaseModule() throw();
Hinweise
Erstellt das CAtlBaseModule-Objekt.
CAtlBaseModule::GetHInstanceAt
Gibt ein Handle an eine angegebene Ressourceninstanz zurück.
HINSTANCE GetHInstanceAt(int i) throw();
Parameter
i
Die Nummer der Ressourceninstanz.
Rückgabewert
Gibt das Handle an die Ressourceninstanz oder NULL zurück, wenn keine entsprechende Ressourceninstanz vorhanden ist.
CAtlBaseModule::GetModuleInstance
Gibt die Modulinstanz aus einem CAtlBaseModule Objekt zurück.
HINSTANCE GetModuleInstance() throw();
Rückgabewert
Gibt die Modulinstanz zurück.
CAtlBaseModule::GetResourceInstance
Gibt die Ressourceninstanz zurück.
HINSTANCE GetResourceInstance() throw();
Rückgabewert
Gibt die Ressourceninstanz zurück.
CAtlBaseModule::m_bInitFailed
Eine Variable, die angibt, ob die Modulinitialisierung fehlgeschlagen ist.
static bool m_bInitFailed;
Hinweise
True, wenn das Modul initialisiert wurde, false, wenn es nicht initialisiert werden konnte.
CAtlBaseModule::RemoveResourceInstance
Entfernt eine Ressourceninstanz aus der Liste der gespeicherten Handles.
bool RemoveResourceInstance(HINSTANCE hInst) throw();
Parameter
hInst
Die zu entfernende Ressourceninstanz.
Rückgabewert
Gibt true zurück, wenn die Ressource erfolgreich entfernt wurde, andernfalls "false".
CAtlBaseModule::SetResourceInstance
Legt die Ressourceninstanz eines CAtlBaseModule Objekts fest.
HINSTANCE SetResourceInstance(HINSTANCE hInst) throw();
Parameter
hInst
Die neue Ressourceninstanz.
Rückgabewert
Gibt die aktualisierte Ressourceninstanz zurück.