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

Описания RDS

Приложения

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

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

А.5.6. Операции с блоками и связями

А.5.6.33. rdsGetNextConn – следующая связь в подсистеме

# Приложения

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

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

#### А.5.6. Операции с блоками и связями

##### А.5.6.33. rdsGetNextConn – следующая связь в подсистеме

Функция rdsGetNextConn возвращает идентификатор связи или шины, следующей за указанной в той же подсистеме.

      RDS_CHANDLE RDSCALL rdsGetNextConn(
        RDS_CHANDLE PrevConn,          // Предыдущая связь/шина
        int Type,                      // Маска типов (RDS_CT*)
        RDS_PCONNDESCRIPTION pDescr    // Заполняемое описание
      );

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

RDS_ChChICd

Параметры

PrevConn(RDS_CHANDLE)
  Идентификатор шины или связи (функция вернет следующую за ней).
Type(int)
  Маска типов, среди которых ищется связь или шина – стандартные константы типов связей RDS_CT*, объединенные битовым ИЛИ. Если нужно найти связь, указывается RDS_CTCONNECTION, если шину – RDS_CTBUS, если любой из этих двух видов связей, можно указать 0. Связь или шина, переданная в параметре PrevConn, не обязательно должна сама попадать в маску Type – функция в любом случае вернет связь указанного типа, следующий за PrevConn.
pDescr(RDS_PCONNDESCRIPTION)
  Указатель на заполняемую функцией структуру описания найденной связи/шины RDS_CONNDESCRIPTION. Если вызывающей программе не нужно это описание, в этом параметре можно передать NULL.

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

Идентификатор найденной связи/шины (RDS_CHANDLE) или NULL, если в подсистеме, в которой находится PrevConn, больше нет связей указанных в Type типов.

Примечания

Эта функция ищет в родительской подсистеме связи/шины PrevConn следующую связь или шину (в зависимости от флагов в параметре Type). Порядок следования связей и шин в подсистеме определяется внутренней логикой RDS и не может быть изменен программистом. Чаще всего эта функция используется вместе с функцией rdsGetFirstConn для перебора всех связей или шин в заданной подсистеме. Например, пару этих функций можно вызвать в цикле for:

      // Перебор всех связей (без шин) подсистемы sys
      for(RDS_CHANDLE conn=rdsGetFirstConn(sys,RDS_CTCONNECTION,NULL);
          conn!=NULL;
          conn=rdsGetNextConn(conn,RDS_CTCONNECTION,NULL))
        {
          // Какие-то действия со связью conn
        }

См. также

rdsGetFirstConn, RDS_CONNDESCRIPTION.