Текущий раздел:

Описания RDS

Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.23. Вспомогательный объект для изменения связей и шин

А.5.23.8. rdsCECreateConnBus – создание связи или шины по данным объекта

# Приложения

## Приложение А. Функции, константы и структуры RDS

### А.5. Сервисные функции и макросы RDS

#### А.5.23. Вспомогательный объект для изменения связей и шин

##### А.5.23.8. rdsCECreateConnBus – создание связи или шины по данным объекта

Функция rdsCECreateConnBus создает новую связь или шину по данным указанного вспомогательного объекта.

      RDS_CHANDLE RDSCALL rdsCECreateConnBus(
        RDS_HOBJECT Editor,  // Объект
        RDS_BHANDLE Parent,  // Подсистема
        int Type,            // Связь или шина
        int *pError          // Результат
      );

Тип указателя на эту функцию

RDS_ChHoBhIpI

Параметры

Editor(RDS_HOBJECT)
  Идентификатор вспомогательного объекта для редактирования связи/шины, ранее созданного функцией rdsCECreateEditor.
Parent(RDS_BHANDLE)
  Идентификатор подсистемы, внутри которой создается связь или шина.
Type(int)
  Тип создаваемого объекта: RDS_CTCONNECTION – создать связь, RDS_CTBUS – создать шину.
pError(int*)
  Указатель на целую переменную, в которую функция запишет результат создания связи или шины (код ошибки):

  RDS_HCE_ERR_OK | Операция выполнена без ошибок.
  RDS_HCE_ERR_BADOBJECT | Editor не является идентификатором вспомогательного объекта для редактирования связи/шины.
  RDS_HCE_ERR_INVBLKBUS | Подсистема с идентификатором Parent отсутствует в схеме.
  RDS_HCE_ERR_BADLINE | Одна из линий связи ссылается на номер точки, отсутствующей в объекте (линия, соединяющая точки, добавлена в объект, а одна из этих точек – нет).
  RDS_HCE_ERR_ALLOC | Прочие ошибки.

  Если вызывающей программе не нужен код ошибки, в параметре pError можно передать NULL.

Возвращаемое значение

Идентификатор созданной связи или шины, или NULL в случае ошибки.

Примечания

Эта функция создает в подсистеме Parent связь или шину (в зависимости от параметра Type) согласно набору точек и линий, содержащемуся во вспомогательном объекте Editor. При создании шины из объекта также читается набор каналов передачи данных.

При создании связей и шин RDS создает в памяти множество дополнительных служебных структур, обеспечивающих их работу. Если планируется последовательное создание нескольких связей или шин, имеет смысл предварительно вызвать функцию rdsSetSystemUpdate с параметром FALSE, а после создания всех связей/шин вызвать ее же с параметром TRUE. Это приведет к тому, что все вспомогательные структуры будут обновляться не после создания каждой связи, а после завершения создания всех связей (в момент вызова функции с параметром TRUE), что может заметно ускорить работу RDS.

Пример

Пример использования функции rdsCECreateConnBus приведен в §2.16.2 руководства программиста.

См. также

rdsCECreateEditor, rdsCEEditConnBus, rdsSetSystemUpdate.