Klasa CAtlComModule

Ta klasa implementuje moduł serwera COM.

Składnia

class CAtlComModule : public _ATL_COM_MODULE

Członkowie

Konstruktory publiczne

Nazwa/nazwisko	opis
CAtlComModule::CAtlComModule	Konstruktor.
CAtlComModule::~CAtlComModule	Destruktora.

Metody publiczne

Nazwa/nazwisko	opis
CAtlComModule::RegisterServer	Wywołaj tę metodę, aby zaktualizować rejestr systemowy dla każdego obiektu na mapie obiektów.
CAtlComModule::RegisterTypeLib	Wywołaj tę metodę, aby zarejestrować bibliotekę typów.
CAtlComModule::UnregisterServer	Wywołaj tę metodę, aby wyrejestrować każdy obiekt na mapie obiektów.
CAtlComModule::UnRegisterTypeLib	Wywołaj tę metodę, aby wyrejestrować bibliotekę typów.

Uwagi

CAtlComModule implementuje moduł serwera COM, umożliwiając klientowi dostęp do składników modułu.

Ta klasa zastępuje przestarzałą klasę CComModule używaną we wcześniejszych wersjach atl. Aby uzyskać więcej informacji, zobacz Klasy modułów ATL.

Hierarchia dziedziczenia

_ATL_COM_MODULE

CAtlComModule

Wymagania

Nagłówek: atlbase.h

CAtlComModule::CAtlComModule

Konstruktor.

CAtlComModule() throw();

Uwagi

Inicjuje moduł.

CAtlComModule::~CAtlComModule

Destruktora.

~CAtlComModule();

Uwagi

Zwalnia wszystkie fabryki klas.

CAtlComModule::RegisterServer

Wywołaj tę metodę, aby zaktualizować rejestr systemowy dla każdego obiektu na mapie obiektów.

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

Parametry

bRegTypeLib
Wartość TRUE, jeśli biblioteka typów ma zostać zarejestrowana. Wartość domyślna to FALSE.

PCLSID
Wskazuje identyfikator CLSID obiektu do zarejestrowania. Jeśli wartość NULL (wartość domyślna), wszystkie obiekty na mapie obiektów zostaną zarejestrowane.

Wartość zwracana

Zwraca S_OK powodzenia lub błąd HRESULT w przypadku niepowodzenia.

Uwagi

Wywołuje funkcję globalną AtlComModuleRegisterServer.

CAtlComModule::RegisterTypeLib

Wywołaj tę metodę, aby zarejestrować bibliotekę typów.

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

Parametry

lpszIndex
Ciąg w formacie "\\N", gdzie N jest indeksem całkowitym zasobu TYPELIB.

Wartość zwracana

Zwraca S_OK powodzenia lub błąd HRESULT w przypadku niepowodzenia.

Uwagi

Dodaje informacje o bibliotece typów do rejestru systemowego. Jeśli wystąpienie modułu zawiera wiele bibliotek typów, użyj pierwszej wersji tej metody, aby określić, która biblioteka typów ma być używana.

CAtlComModule::UnregisterServer

Wywołaj tę metodę, aby wyrejestrować każdy obiekt na mapie obiektów.

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

Parametry

bRegTypeLib
Wartość TRUE, jeśli biblioteka typów ma być wyrejestrowana. Wartość domyślna to FALSE.

PCLSID
Wskazuje identyfikator CLSID obiektu do wyrejestrowania. Jeśli wartość NULL (wartość domyślna), wszystkie obiekty na mapie obiektów zostaną wyrejestrowane.

Wartość zwracana

Zwraca S_OK powodzenia lub błąd HRESULT w przypadku niepowodzenia.

Uwagi

Wywołuje funkcję globalną AtlComModuleUnregisterServer.

CAtlComModule::UnRegisterTypeLib

Wywołaj tę metodę, aby wyrejestrować bibliotekę typów.

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

Parametry

lpszIndex
Ciąg w formacie "\\N", gdzie N jest indeksem całkowitym zasobu TYPELIB.

Uwagi

Usuwa informacje o bibliotece typów z rejestru systemowego. Jeśli wystąpienie modułu zawiera wiele bibliotek typów, użyj pierwszej wersji tej metody, aby określić, która biblioteka typów ma być używana.

Wartość zwracana

Zwraca S_OK powodzenia lub błąd HRESULT w przypadku niepowodzenia.

Zobacz też

_ATL_COM_MODULE
Omówienie klasy