Udostępnij za pośrednictwem


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.

Zobacz też

Funkcje