GetDomainSystem: различия между версиями

Материал из CAMaaS preliminary wiki
Перейти к навигации Перейти к поиску
Строка 6: Строка 6:
{{function paramlist add|ppDomain|Выходной буфер, принимающий адрес реализации [[подсистема предметной области|подсистемы предметной области]] с интерфейсом [[IDomainSystem]].|paramdir=[out]}}
{{function paramlist add|ppDomain|Выходной буфер, принимающий адрес реализации [[подсистема предметной области|подсистемы предметной области]] с интерфейсом [[IDomainSystem]].|paramdir=[out]}}
{{function paramlist end}}
{{function paramlist end}}
{{function return_value|Четырехбайтовое беззнаковое целое - код ответа подсистемы предметной области, установленный с помощью метода [[IControlSystemDomainSide::FormResponse]].}}
{{function return_value|32-битовый целый код ошибки, который в случае успешного выполнения неотрицателен.}}
{{function sa begin}}
{{function sa begin}}
{{function sa add|[[IDomainSystem]]|{{IDomainSystem brief}}}}
{{function sa add|[[IDomainSystem]]|{{IDomainSystem brief}}}}

Версия 17:40, 22 декабря 2017

Компоненты на верхнем уровне \ Вычислительная подсистема \ Подсистема предметной области \ GetDomainSystem
return_code_t PLATFORM_NATIVE_CALLING_CONVENTION GetDomainSystem(std::uint32_t nFlags, void* pParams, IDomainSystem** ppDomain);

Точка входа во внутрипроцессную реализацию экземпляра подсистемы предметной области, возвращающая объект с интерфейсом IDomainSystem.

Параметры
[in]nFlagsЗарезервированный целочисленный параметр, который должен принимать значение 0.
[in]pParamsЗарезервированный указатель, который должен принимать значение nullptr.
[out]ppDomainВыходной буфер, принимающий адрес реализации подсистемы предметной области с интерфейсом IDomainSystem.
Возвращаемое значение:
32-битовый целый код ошибки, который в случае успешного выполнения неотрицателен.
См. также
IDomainSystemОсновной программный интерфейс экземпляра подсистемы предметной области.
domain_entrypoint_typeТип функции GetDomainSystem.
GetNodeТочка входа во внутрипроцессную реализацию вычислительного узла подсистемы предметной области, возвращающая объект с интерфейсом INode..
Использование GetDomainSystem в распределенной конфигурации экземпляра подсистемы предметной области.

Возвращаемое через ppDomain значение имеет тип указателя на программную реализацию интерфейса IDomainSystem экземпляра подсистемы предметной области. Данный указатель, в случае, если используется внутрипроцессная конфигурация экземпляра подсистемы предметной области, может быть использован подсистемой управления непосредственно, или - если используется распределенная конфигурация - через прокси-объект, делегирующий вызов через методы интерфейса IDomainSystem.

На стороне локального клиента (т.е. подсистемы управления или ее заглушки-враппера в адресном пространстве подсистемы предметной области) данный интерфейс может быть переписан в соответствии с правилами языка, на котором реализован клиент. В частности, ссылка и указатели имеют одинаковое представление и поэтому взаимозаменяемы, а возвращаемый тип void * может быть заменен типом IDomainSystem*. См. Межъязыковая совместимость интерфейсов C и C++.