CAtlComModule-klasse

Opmerking

De ATL (Active Template Library) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Met deze klasse wordt een COM-servermodule geïmplementeerd.

Syntaxis

class CAtlComModule : public _ATL_COM_MODULE

Leden

Openbare constructors

Naam	Description
CAtlComModule::CAtlComModule	De constructor.
CAtlComModule::~CAtlComModule	De destructor.

Openbare methoden

Naam	Description
CAtlComModule::RegisterServer	Roep deze methode aan om het systeemregister voor elk object in de objecttoewijzing bij te werken.
CAtlComModule::RegisterTypeLib	Roep deze methode aan om een typebibliotheek te registreren.
CAtlComModule::UnregisterServer	Roep deze methode aan om de registratie van elk object in de objecttoewijzing ongedaan te maken.
CAtlComModule::UnRegisterTypeLib	Roep deze methode aan om de registratie van een typebibliotheek ongedaan te maken.

Opmerkingen

CAtlComModule implementeert een COM-servermodule, zodat een client toegang heeft tot de onderdelen van de module.

Deze klasse vervangt de verouderde CComModule-klasse die wordt gebruikt in eerdere versies van ATL. Zie ATL-moduleklassen voor meer informatie.

Overnamehiërarchie

_ATL_COM_MODULE

CAtlComModule

Requirements

Header: atlbase.h

CAtlComModule::CAtlComModule

De constructor.

CAtlComModule() throw();

Opmerkingen

Initialiseert de module.

CAtlComModule::~CAtlComModule

De destructor.

~CAtlComModule();

Opmerkingen

Alle klassefabrieken worden vrijgemaakt.

CAtlComModule::RegisterServer

Roep deze methode aan om het systeemregister voor elk object in de objecttoewijzing bij te werken.

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

Parameterwaarden

bRegTypeLib
WAAR als de typebibliotheek moet worden geregistreerd. De standaardwaarde is FALSE.

pCLSID
Verwijst naar de CLSID van het object dat moet worden geregistreerd. Als NULL (de standaardwaarde), worden alle objecten in de objecttoewijzing geregistreerd.

Retourwaarde

Retourneert S_OK bij succes of een fout HRESULT bij fout.

Opmerkingen

Roept de globale functie AtlComModuleRegisterServer aan.

CAtlComModule::RegisterTypeLib

Roep deze methode aan om een typebibliotheek te registreren.

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

Parameterwaarden

lpszIndex
Tekenreeks in de notatie \\N, waarbij N de gehele index van de TYPELIB-resource is.

Retourwaarde

Retourneert S_OK bij succes of een fout HRESULT bij fout.

Opmerkingen

Hiermee voegt u informatie over een typebibliotheek toe aan het systeemregister. Als het module-exemplaar meerdere typebibliotheken bevat, gebruikt u de eerste versie van deze methode om op te geven welke typebibliotheek moet worden gebruikt.

CAtlComModule::UnregisterServer

Roep deze methode aan om de registratie van elk object in de objecttoewijzing ongedaan te maken.

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

Parameterwaarden

bRegTypeLib
WAAR als de typebibliotheek moet worden opgehefd. De standaardwaarde is FALSE.

pCLSID
Verwijst naar de CLSID van het object om de registratie ongedaan te maken. Als NULL (de standaardwaarde) wordt de registratie van alle objecten in de objecttoewijzing ongedaan gemaakt.

Retourwaarde

Retourneert S_OK bij succes of een fout HRESULT bij fout.

Opmerkingen

Roept de globale functie AtlComModuleUnregisterServer aan.

CAtlComModule::UnRegisterTypeLib

Roep deze methode aan om de registratie van een typebibliotheek ongedaan te maken.

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

Parameterwaarden

lpszIndex
Tekenreeks in de notatie \\N, waarbij N de gehele index van de TYPELIB-resource is.

Opmerkingen

Hiermee verwijdert u informatie over een typebibliotheek uit het systeemregister. Als het module-exemplaar meerdere typebibliotheken bevat, gebruikt u de eerste versie van deze methode om op te geven welke typebibliotheek moet worden gebruikt.

Retourwaarde

Retourneert S_OK bij succes of een fout HRESULT bij fout.

Zie ook

_ATL_COM_MODULE
Overzicht van klassen