Глобальные функции регистрации серверов
Эти функции обеспечивают поддержку регистрации и отмены регистрации объектов сервера на карте объектов.
Внимание
Функции, перечисленные в следующей таблице, нельзя использовать в приложениях, которые выполняются в среда выполнения Windows.
| Имя | Описание |
|---|---|
| AtlComModuleRegisterServer | Эта функция вызывается для регистрации каждого из объектов в карте объектов. |
| AtlComModuleUnregisterServer | Эта функция вызывается для отмены регистрации каждого из объектов в карте объектов. |
| AtlComModuleRegisterClassObjects | Эта функция вызывается для регистрации объектов класса. |
| AtlComModuleRevokeClassObjects | Эта функция вызывается для отзыва объектов класса из com-модуля. |
| AtlComModuleGetClassObject | Эта функция вызывается для получения объекта класса. |
Требования
Заголовок: atlbase.h
AtlComModuleRegisterServer
Эта функция вызывается для регистрации каждого из объектов в карте объектов.
ATLINLINE ATLAPI AtlComModuleRegisterServer(
_ATL_COM_MODULE* pComModule,
BOOL bRegTypeLib,
const CLSID* pCLSID);
Параметры
pComModule
Указатель на com-модуль.
bRegTypeLib
Значение TRUE, если библиотека типов должна быть зарегистрирована.
pCLSID
Указывает на CLSID объекта, который необходимо зарегистрировать. Если значение NULL, все объекты на карте объектов будут зарегистрированы.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
Замечания
AtlComModuleRegisterServer выполняет пошаговые инструкции по сопоставлению объектов ATL и регистрирует каждый объект в карте. Если pCLSID не равно NULL, регистрируется только объект, на который ссылается pCLSID ; в противном случае регистрируются все объекты.
Эта функция вызывается CAtlComModule::RegisterServer.
AtlComModuleUnregisterServer
Эта функция вызывается для отмены регистрации каждого из объектов в карте объектов.
ATLINLINE ATLAPI AtlComModuleUnregisterServer(
_ATL_COM_MODULE* pComModule,
BOOL bUnRegTypeLib,
const CLSID* pCLSID);
Параметры
pComModule
Указатель на com-модуль.
bUnRegTypeLib
Значение TRUE, если библиотека типов должна быть зарегистрирована.
pCLSID
Указывает на CLSID объекта, который требуется отменить регистрацию. Если все объекты в карте объектов NULL будут отменены.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
Замечания
AtlComModuleUnregisterServer пошаговые инструкции по карте объектов ATL и отменяют регистрацию каждого объекта в карте. Если pCLSID не равно NULL, то только объект, на который ссылается pCLSID, отменяется. В противном случае все объекты отменяются.
Эта функция вызывается CAtlComModule::UnregisterServer.
AtlComModuleRegisterClassObjects
Эта функция вызывается для регистрации объектов класса.
ATLINLINE ATLAPI AtlComModuleRegisterClassObjects(
_ATL_COM_MODULE* pComModule,
DWORD dwClsContext,
DWORD dwFlags);
Параметры
pComModule
Указатель на com-модуль.
dwClsContext
Указывает контекст, в котором должен выполняться объект класса. Возможные значения: CLSCTX_INPROC_SERVER, CLSCTX_INPROC_HANDLER или CLSCTX_LOCAL_SERVER. Дополнительные сведения см. в разделе CLSCTX .
dwFlags
Определяет типы подключений к объекту класса. Возможные значения: REGCLS_SINGLEUSE, REGCLS_MULTIPLEUSE или REGCLS_MULTI_SEPARATE. Дополнительные сведения см. в разделе REGCLS .
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
Замечания
Эта вспомогательной функцией используется CComModule::RegisterClassObjects (устаревшая в ATL 7.0) и CAtlExeModuleT::RegisterClassObjects.
AtlComModuleRevokeClassObjects
Эта функция вызывается для удаления фабрики или фабрик класса из таблицы запущенных объектов.
ATLINLINE ATLAPI AtlComModuleRevokeClassObjects(_ATL_COM_MODULE* pComModule);
Параметры
pComModule
Указатель на com-модуль.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
Замечания
Эта вспомогательной функцией используется CComModule::RevokeClassObjects (устаревшая в ATL 7.0) и CAtlExeModuleT::RevokeClassObjects.
AtlComModuleGetClassObject
Эта функция вызывается для получения фабрики класса.
ATLINLINE ATLAPI AtlComModuleGetClassObject(
_ATL_COM_MODULE* pComModule,
REFCLSID rclsid,
REFIID riid,
LPVOID* ppv);
Параметры
pComModule
Указатель на com-модуль.
rclsid
CLSID создаваемого объекта.
riid
IID запрошенного интерфейса.
ppv
Указатель на указатель интерфейса, определяемый идентификатором riid. Если объект не поддерживает этот интерфейс, ppv имеет значение NULL.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
Замечания
Эта вспомогательной функцией используется CComModule::GetClassObject (устаревшая в ATL 7.0) и CAtlDllModuleT::GetClassObject.