Приложения

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

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

А.5.25. Вспомогательный объект для изменения структуры переменных блока

А.5.25.40. Макрос rdsVSGetAutoMain – получить имя основной переменной по номеру связи

Макрос rdsVSGetAutoMain возвращает имя основной переменной по номеру ее связи со вспомогательной.

  rdsVSGetAutoMainA( // UTF8
    vars,      // Вспомогательный объект
    num        // Номер связи
  )
  rdsVSGetAutoMainW( // UTF16
    vars,      // Вспомогательный объект
    num        // Номер связи
  )
  // Через функцию-псевдоним
  rdsVSGetAutoMain( // Кодировка по умолчанию
    vars,      // Вспомогательный объект
    num        // Номер связи
  )

Определения

  #define rdsVSGetAutoMainA(vars,num) \
    rdsGetObjectStrA((vars),RDS_HVAR_GETAUTOMAIN,(num))
  #define rdsVSGetAutoMainW(vars,num) \
    rdsGetObjectStrW((vars),RDS_HVAR_GETAUTOMAIN,(num))
  // Через функцию-псевдоним
  #define rdsVSGetAutoMain(vars,num) \
    rdsGetObjectStr((vars),RDS_HVAR_GETAUTOMAIN,(num))

Параметры

vars (RDS_HOBJECT)

Идентификатор вспомогательного объекта-редактора переменных, ранее созданного функцией rdsVSCreateEditor.

num (целое)

Целое число – номер связи переменных.

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

Указатель на строку (const char* или const wchar_t*, в зависимости от версии макроса) во внутренней памяти RDS, в которой записано имя основной переменной, или NULL, если связи с номером num нет в объекте vars.

Примечания

Этот макрос заключает в себя вызов команды RDS_HVAR_GETAUTOMAIN.