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