IControlSystemDomainSide::FormResponse

Материал из CAMaaS preliminary wiki
Перейти к навигации Перейти к поиску
Компоненты на верхнем уровне \ Подсистема управления \ IControlSystemDomainSide \ FormResponse
domain_response_code_t FormResponse(return_code_t nReturnCode, _In_opt_z_count_(cbErrorDescription) const char* pErrorDescription, 
		size_type cbErrorDescription) const;

При вызове со стороны подсистемы предметной области формирует результат обработки запроса, поступившего со стороны подсистемы управления, с возможным текстовым описанием.

Параметры
nReturnCode32-битовый код ошибки в формате chsvlib. Коды, для которых _ChsvCode_Facility(nReturnCode) == CHSV_FACILITY_GENERAL будут анализироваться подсистемой управления. Код, установленный в 0 (CHSVERROR_SUCCESS) является кодом по умолчанию (перегрузка 4), сидетельствующим о норамльном завершении операции. Коды с установленным старшим битом (т.е. коды, для которых выполняется предикат _ChsvSucceeded(nReturnCode)) также свидетельствуют об успешности операции, но при этом устанавливаются специальные сведения о пространстве (см. _ChsvCode_Facility) и значении кода рзультата.
[in]pErrorDescriptionОпциональное текстовое описание ошибки, передаваемое подсистеме управления. Может быть установлено в nullptr.
cbErrorDescriptionДлина строки pErrorDescription в байтах. Если pErrorDescription == nullptr, cbErrorDescription должно быть 0.
Возвращаемое значение:
Сформированный код ответа предметной области. В случае, если nResponseCode == 0 и pErrorDescription == nullptr, функция просто возвращает целое значение 0. В противном случае, функция создает динамическую структуру данных с кодом и описанием ошибки и возвращает приведенный к целому указатель на нее.
См. также
domain_response_code_tВозвращаемый тип.