Приложения

Приложение А. Функции, константы и структуры 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.