Приложения

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