Funkcje globalne rejestracji serwera
Te funkcje zapewniają obsługę rejestrowania i wyrejestrowania obiektów serwera na mapie obiektów.
Ważne
Funkcje wymienione w poniższej tabeli nie mogą być używane w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows.
| Nazwa/nazwisko | opis |
|---|---|
| AtlComModuleRegisterServer | Ta funkcja jest wywoływana, aby zarejestrować każdy obiekt na mapie obiektów. |
| AtlComModuleUnregisterServer | Ta funkcja jest wywoływana, aby wyrejestrować każdy obiekt na mapie obiektów. |
| AtlComModuleRegisterClassObjects | Ta funkcja jest wywoływana, aby zarejestrować obiekty klasy. |
| AtlComModuleRevokeClassObjects | Ta funkcja jest wywoływana w celu odwołania obiektów klas z modułu COM. |
| AtlComModuleGetClassObject | Ta funkcja jest wywoływana w celu pobrania obiektu klasy. |
Wymagania
Nagłówek: atlbase.h
AtlComModuleRegisterServer
Ta funkcja jest wywoływana, aby zarejestrować każdy obiekt na mapie obiektów.
ATLINLINE ATLAPI AtlComModuleRegisterServer(
_ATL_COM_MODULE* pComModule,
BOOL bRegTypeLib,
const CLSID* pCLSID);
Parametry
moduł pComModule
Wskaźnik do modułu COM.
bRegTypeLib
Wartość TRUE, jeśli biblioteka typów ma zostać zarejestrowana.
PCLSID
Wskazuje identyfikator CLSID obiektu do zarejestrowania. Jeśli wartość NULL, wszystkie obiekty na mapie obiektów zostaną zarejestrowane.
Wartość zwracana
Zwraca S_OK powodzenia lub błąd HRESULT w przypadku niepowodzenia.
Uwagi
AtlComModuleRegisterServer Program przeprowadzi mapę automatycznie wygenerowanych obiektów ATL i rejestruje każdy obiekt na mapie. Jeśli identyfikator pCLSID nie ma wartości NULL, zarejestrowany jest tylko obiekt, do których odwołuje się identyfikator pCLSID . W przeciwnym razie wszystkie obiekty są zarejestrowane.
Ta funkcja jest wywoływana przez CAtlComModule::RegisterServer.
AtlComModuleUnregisterServer
Ta funkcja jest wywoływana, aby wyrejestrować każdy obiekt na mapie obiektów.
ATLINLINE ATLAPI AtlComModuleUnregisterServer(
_ATL_COM_MODULE* pComModule,
BOOL bUnRegTypeLib,
const CLSID* pCLSID);
Parametry
moduł pComModule
Wskaźnik do modułu COM.
bUnRegTypeLib
Wartość TRUE, jeśli biblioteka typów ma zostać zarejestrowana.
PCLSID
Wskazuje identyfikator CLSID obiektu do wyrejestrowania. Jeśli wszystkie obiekty na mapie obiektów mają wartość NULL, zostaną wyrejestrowane.
Wartość zwracana
Zwraca S_OK powodzenia lub błąd HRESULT w przypadku niepowodzenia.
Uwagi
AtlComModuleUnregisterServer Program przeprowadzi mapę obiektów ATL i wyrejestruje każdy obiekt na mapie. Jeśli identyfikator pCLSID nie ma wartości NULL, tylko obiekt, do których odwołuje się identyfikator pCLSID , jest wyrejestrowany. W przeciwnym razie wszystkie obiekty są wyrejestrowane.
Ta funkcja jest wywoływana przez CAtlComModule::UnregisterServer.
AtlComModuleRegisterClassObjects
Ta funkcja jest wywoływana, aby zarejestrować obiekty klasy.
ATLINLINE ATLAPI AtlComModuleRegisterClassObjects(
_ATL_COM_MODULE* pComModule,
DWORD dwClsContext,
DWORD dwFlags);
Parametry
moduł pComModule
Wskaźnik do modułu COM.
dwClsContext
Określa kontekst, w którym ma zostać uruchomiony obiekt klasy. Możliwe wartości to CLSCTX_INPROC_SERVER, CLSCTX_INPROC_HANDLER lub CLSCTX_LOCAL_SERVER. Aby uzyskać więcej informacji, zobacz CLSCTX .
dwFlags
Określa typy połączeń z obiektem klasy. Możliwe wartości to REGCLS_SINGLEUSE, REGCLS_MULTIPLEUSE lub REGCLS_MULTI_SEPARATE. Aby uzyskać więcej informacji, zobacz REGCLS .
Wartość zwracana
Zwraca S_OK powodzenia lub błąd HRESULT w przypadku niepowodzenia.
Uwagi
Ta funkcja pomocnika jest używana przez klasy CComModule::RegisterClassObjects (przestarzałe w atl 7.0) i CAtlExeModuleT::RegisterClassObjects.
AtlComModuleRevokeClassObjects
Ta funkcja jest wywoływana, aby usunąć fabrykę/fabryki klas z tabeli działających obiektów.
ATLINLINE ATLAPI AtlComModuleRevokeClassObjects(_ATL_COM_MODULE* pComModule);
Parametry
moduł pComModule
Wskaźnik do modułu COM.
Wartość zwracana
Zwraca S_OK powodzenia lub błąd HRESULT w przypadku niepowodzenia.
Uwagi
Ta funkcja pomocnika jest używana przez klasy CComModule::RevokeClassObjects (przestarzałe w atl 7.0) i CAtlExeModuleT::RevokeClassObjects.
AtlComModuleGetClassObject
Ta funkcja jest wywoływana, aby zwrócić fabrykę klasy.
ATLINLINE ATLAPI AtlComModuleGetClassObject(
_ATL_COM_MODULE* pComModule,
REFCLSID rclsid,
REFIID riid,
LPVOID* ppv);
Parametry
moduł pComModule
Wskaźnik do modułu COM.
rclsid
Identyfikator CLSID obiektu do utworzenia.
riid
Identyfikator IID żądanego interfejsu.
ppv
Wskaźnik do wskaźnika interfejsu zidentyfikowany przez riid. Jeśli obiekt nie obsługuje tego interfejsu, wartość ppv jest ustawiona na wartość NULL.
Wartość zwracana
Zwraca S_OK powodzenia lub błąd HRESULT w przypadku niepowodzenia.
Uwagi
Ta funkcja pomocnika jest używana przez CComModule::GetClassObject (przestarzałe w atl 7.0) i CAtlDllModuleT::GetClassObject.