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

Описания RDS

Приложения

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

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

А.5.14. Общие функции работы с переменными блока

А.5.14.14. rdsGetStructVar – структура по номеру

# Приложения

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

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

#### А.5.14. Общие функции работы с переменными блока

##### А.5.14.14. rdsGetStructVar – структура по номеру

Функция rdsGetStructVar возвращает идентификатор структуры с заданным номером в общем списке структур RDS.

      RDS_VHANDLE RDSCALL rdsGetStructVar(
        int StructNum,              // Номер структуры
        RDS_PVARDESCRIPTION pDescr  // Заполняемое описание
      );

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

RDS_VhIVd

Параметры

StructNum(int)
  Порядковый номер структуры в общем списке (начиная с нуля).
pDescr(RDS_PVARDESCRIPTION)
  Указатель на структуру описания переменной RDS_VARDESCRIPTION, которую функция должна заполнить параметрами структуры с указанным номером. Если вызывающей программе не нужно это описание, в этом параметре можно передать NULL.

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

Идентификатор структуры (тип RDS_VHANDLE) или NULL, если структура с номером StructNum отсутствует в общем списке структур, зарегистрированных в схеме.

Примечания

Эта функция позволяет найти идентификатор структуры с заданным номером в общем списке структур RDS. Каждая из этих структур представляет собой обычную переменную и, как и переменные блоков, имеет идентификатор RDS_VHANDLE. Общее число зарегистрированных структур можно получить вызовом функции rdsGetSystemInt с параметром RDS_GSIINSTSTRUCTCOUNT.

См. также

rdsFindStructVar, RDS_VARDESCRIPTION, rdsGetSystemInt.