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

Материал из CAMaaS preliminary wiki
Перейти к навигации Перейти к поиску
Строка 1: Строка 1:
{{NavBar|{{Системная иерархия:Подсистема предметной области}} \ [[GetDomainSystem]]}}
{{NavBar|{{Системная иерархия:Подсистема предметной области}} \ [[GetDomainSystem]]}}
{{function begin|return_code_t PLATFORM_NATIVE_CALLING_CONVENTION GetDomainSystem(std::uint32_t nFlags, void* pParams, IDomainSystem** ppDomain);|{{GetDomainSystem brief}}.}}
{{function begin|return_code_t PLATFORM_NATIVE_CALLING_CONVENTION GetDomainSystem(std::uint32_t nFlags, void* pParams, IDomainSystem** ppDomain);|{{GetDomainSystem brief}}}}
{{function paramlist begin}}
{{function paramlist begin}}
{{function paramlist add|nFlags|Зарезервированный целочисленный параметр, который должен принимать значение 0.|paramdir=[in]}}
{{function paramlist add|nFlags|Зарезервированный целочисленный параметр, который должен принимать значение 0.|paramdir=[in]}}

Версия 17:25, 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.
Возвращаемое значение:
Четырехбайтовое беззнаковое целое - код ответа подсистемы предметной области, установленный с помощью метода IControlSystemDomainSide::FormResponse.
См. также
IDomainSystemПрограммный интерфейс, реализуемый возвращаемым функцией объектом.
Использование GetDomainSystem в распределенной конфигурации экземпляра подсистемы предметной области.

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

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