Глобальные функции регистрации серверов

Эти функции обеспечивают поддержку регистрации и отмены регистрации объектов сервера на карте объектов.

Важно!

Функции, перечисленные в следующей таблице, нельзя использовать в приложениях, которые выполняются в среда выполнения 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.

См. также

Функции