Приложения

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

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

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

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

Макрос rdsVSGetAutoConn возвращает имя вспомогательной переменной из связи основных и вспомогательных переменных с заданным номером.

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

Определения

  #define rdsVSGetAutoConnA(vars,num) \
    rdsGetObjectStrA((vars),RDS_HVAR_GETAUTOCONN,(num))
  #define rdsVSGetAutoConnW(vars,num) \
    rdsGetObjectStrW((vars),RDS_HVAR_GETAUTOCONN,(num))
  // Через функцию-псевдоним
  #define rdsVSGetAutoConn(vars,num) \
    rdsGetObjectStr((vars),RDS_HVAR_GETAUTOCONN,(num))

Параметры

vars (RDS_HOBJECT)

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

num (целое)

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

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

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

Примечания

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