Klasa CAtlComModule
Ta klasa implementuje moduł serwera COM.
Składnia
class CAtlComModule : public _ATL_COM_MODULE
Elementy członkowskie
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
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.