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

Описания RDS

Приложения

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

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

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

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

# Приложения

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