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

Описания RDS

Приложения

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

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

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

А.5.6.27. rdsGetFirstConn – первая связь в подсистеме

# Приложения

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

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

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

##### А.5.6.27. rdsGetFirstConn – первая связь в подсистеме

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

      RDS_CHANDLE RDSCALL rdsGetFirstConn(
        RDS_BHANDLE Parent,            // Подсистема
        int Type,                      // Маска типов (RDS_CT*)
        RDS_PCONNDESCRIPTION pDescr    // Заполняемое описание
      );

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

RDS_ChBhICd

Параметры

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

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

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

Примечания

Эта функция ищет в подсистеме Parent самую первую связь или шину (в зависимости от флагов в параметре Type). Порядок следования связей и шин в подсистеме (и понятие «самая первая связь» для этой функции) определяется внутренней логикой RDS и не может быть изменен программистом. Чаще всего эта функция используется вместе с функцией rdsGetNextConn для перебора всех связей или шин в заданной подсистеме.

См. также

rdsGetNextConn, RDS_CONNDESCRIPTION.