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

_ATL_BASE_MODULE

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.

Siehe auch

Klassenübersicht
Modulklassen