Приложения

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

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

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

А.5.14.18. rdsSetBlockVarFlags – установить флаги переменной

Функция rdsSetBlockVarFlags устанавливает различные битовые флаги указанной переменной указанного блока.

  BOOL RDSCALL rdsSetBlockVarFlags(
    RDS_BHANDLE Block,  // Идентификатор блока
    int VarNum,         // Номер переменной
    DWORD Flags,        // Флаги
    DWORD Mask          // Маска
  );

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

RDS_BBhIDwDw

Параметры

Block (RDS_BHANDLE)

Идентификатор блока, которому принадлежит переменная. Если в этом параметре передано значение NULL, функция будет работать с блоком, из модели которого она вызвана.

VarNum (int)

Порядковый номер переменной в блоке (начиная с нуля).

Flags (DWORD)

Набор битовых флагов переменной RDS_VARFLAG_* (см. поле Flags структуры RDS_VARDESCRIPTION).

Mask (DWORD)

Маска изменяемых битовых флагов (единичные биты в позиции тех флагов, которые нужно изменить в переменной VarNum согласно Flags).

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

TRUE – флаги переменной установлены, FALSE – в блоке нет переменной с таким номером.

Примечания

Эта функция устанавливает и сбрасывает битовые флаги, определяющие поведение переменной с номером VarNum в блоке Block. В параметре Flags передается целое число, у которого в позициях, соответствующих взводимым флагам, будут находиться единичные биты, а в позициях, соответствующих сбрасываемым – нулевые. При этом в параметре Mask должно быть передано целое число, у которого единичные биты соответствуют изменяемым (взводимым или сбрасываемым) флагам, а нулевые – флагам, остающимся неизменными.

Пример

См. также

RDS_VARDESCRIPTION, rdsVSSetVarFlags.