Globální funkce serverové registrace
Tyto funkce poskytují podporu pro registraci a zrušení registrace objektů serveru v mapě objektu.
Důležité
Funkce uvedené v následující tabulce nelze použít v aplikacích, které se spouští v prostředí Windows Runtime.
| Název | Popis |
|---|---|
| AtlComModuleRegisterServer | Voláním této funkce se zaregistrují všechny objekty v mapě objektů. |
| AtlComModuleUnregisterServer | Voláním této funkce se zruší registrace všech objektů v mapě objektů. |
| AtlComModuleRegisterClassObjects | Voláním této funkce se zaregistrují objekty třídy. |
| AtlComModuleRevokeClassObjects | Tato funkce je volána k odvolání objektů třídy z modulu COM. |
| AtlComModuleGetClassObject | Tato funkce je volána k získání objektu třídy. |
Požadavky
Hlavička: atlbase.h
AtlComModuleRegisterServer
Voláním této funkce se zaregistrují všechny objekty v mapě objektů.
ATLINLINE ATLAPI AtlComModuleRegisterServer(
_ATL_COM_MODULE* pComModule,
BOOL bRegTypeLib,
const CLSID* pCLSID);
Parametry
pComModule
Ukazatel na modul COM.
bRegTypeLib
TRUE, pokud je knihovna typů registrována.
pCLSID
Odkazuje na CLSID objektu, který se má zaregistrovat. Pokud je hodnota NULL, budou všechny objekty v mapě objektu zaregistrovány.
Návratová hodnota
Vrátí S_OK při úspěchu nebo chybu HRESULT při selhání.
Poznámky
AtlComModuleRegisterServer provede mapování automaticky vygenerovaného objektu ATL a zaregistruje každý objekt v mapě. Pokud hodnota pCLSID není NULL, zaregistruje se pouze objekt odkazovaný parametrem pCLSID . V opačném případě jsou všechny objekty registrovány.
Tuto funkci volá CAtlComModule::RegisterServer.
AtlComModuleUnregisterServer
Voláním této funkce se zruší registrace všech objektů v mapě objektů.
ATLINLINE ATLAPI AtlComModuleUnregisterServer(
_ATL_COM_MODULE* pComModule,
BOOL bUnRegTypeLib,
const CLSID* pCLSID);
Parametry
pComModule
Ukazatel na modul COM.
bUnRegTypeLib
TRUE, pokud je knihovna typů registrována.
pCLSID
Odkazuje na CLSID objektu, který se má zrušit registrace. Pokud budou všechny objekty v mapě objektů zrušeny.
Návratová hodnota
Vrátí S_OK při úspěchu nebo chybu HRESULT při selhání.
Poznámky
AtlComModuleUnregisterServer provede mapování objektů ATL a zruší registraci každého objektu v mapě. Pokud pCLSID není NULL, pak se zruší registrace pouze objekt odkazovaný pomocí pCLSID ; jinak všechny objekty nejsou registrace.
Tuto funkci volá CAtlComModule::UnregisterServer.
AtlComModuleRegisterClassObjects
Voláním této funkce se zaregistrují objekty třídy.
ATLINLINE ATLAPI AtlComModuleRegisterClassObjects(
_ATL_COM_MODULE* pComModule,
DWORD dwClsContext,
DWORD dwFlags);
Parametry
pComModule
Ukazatel na modul COM.
dwClsContext
Určuje kontext, ve kterém má být objekt třídy spuštěn. Možné hodnoty jsou CLSCTX_INPROC_SERVER, CLSCTX_INPROC_HANDLER nebo CLSCTX_LOCAL_SERVER. Další podrobnosti najdete v modulu CLSCTX.
dwFlags
Určuje typy připojení k objektu třídy. Možné hodnoty jsou REGCLS_SINGLEUSE, REGCLS_MULTIPLEUSE nebo REGCLS_MULTI_SEPARATE. Další podrobnosti najdete v tématu REGCLS.
Návratová hodnota
Vrátí S_OK při úspěchu nebo chybu HRESULT při selhání.
Poznámky
Tuto pomocnou funkci využívá CComModule::RegisterClassObjects (zastaralé v ATL 7.0) a CAtlExeModuleT::RegisterClassObjects.
AtlComModuleRevokeClassObjects
Voláním této funkce se z tabulky spuštěných objektů odeberou objekty pro vytváření tříd.
ATLINLINE ATLAPI AtlComModuleRevokeClassObjects(_ATL_COM_MODULE* pComModule);
Parametry
pComModule
Ukazatel na modul COM.
Návratová hodnota
Vrátí S_OK při úspěchu nebo chybu HRESULT při selhání.
Poznámky
Tuto pomocnou funkci využívá CComModule::RevokeClassObjects (zastaralé v ATL 7.0) a CAtlExeModuleT::RevokeClassObjects.
AtlComModuleGetClassObject
Voláním této funkce se vrátí objekt pro vytváření tříd.
ATLINLINE ATLAPI AtlComModuleGetClassObject(
_ATL_COM_MODULE* pComModule,
REFCLSID rclsid,
REFIID riid,
LPVOID* ppv);
Parametry
pComModule
Ukazatel na modul COM.
rclsid
CLSID objektu, který se má vytvořit.
riid
IID požadovaného rozhraní.
ppv
Ukazatel na ukazatel rozhraní identifikovaný riidem. Pokud objekt nepodporuje toto rozhraní, ppv je nastaven na hodnotu NULL.
Návratová hodnota
Vrátí S_OK při úspěchu nebo chybu HRESULT při selhání.
Poznámky
Tuto pomocnou funkci využívá CComModule::GetClassObject (zastaralé v ATL 7.0) a CAtlDllModuleT::GetClassObject.