Приложения

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

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

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

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

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

  BOOL RDSCALL rdsCEEditConnBus(
    RDS_HOBJECT Editor,  // Объект
    RDS_CHANDLE Conn,    // Существующая связь/шина
    int *pError          // Результат
  );

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

RDS_BHoChI

Параметры

Editor (RDS_HOBJECT)

Идентификатор вспомогательного объекта для редактирования связи/шины, ранее созданного функцией rdsCECreateEditor.

Conn (RDS_CHANDLE)

Идентификатор связи или шины, которую должна изменить функция.

pError (int*)

Указатель на целую переменную, в которую функция запишет результат изменения связи или шины (код ошибки):

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

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

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

TRUE – изменение выполнено, FALSE – ошибка.

Примечания

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

См. также

rdsCECreateEditor, rdsCECreateConnBus, rdsSetSystemUpdate.