Приложения
Приложение А. Функции, константы и структуры RDS
А.5. Сервисные функции и макросы RDS
А.5.25. Вспомогательный объект для изменения структуры переменных блока
А.5.25.22. Команда RDS_HVAR_GETAUTOCONN – получить имя связанной переменной по номеру связи
Команда RDS_HVAR_GETAUTOCONN возвращает имя вспомогательной переменной из связи основных и вспомогательных переменных с заданным номером.
Вызов команды
int iNum= … // Номер связи "основная-вспомогательная" RDSCSTR strName=rdsGetObjectStrA(Vars,RDS_HVAR_GETAUTOCONN,iNum); // UTF8
или
int iNum= … // Номер связи "основная-вспомогательная" RDSWCSTR strName=rdsGetObjectStrW(Vars,RDS_HVAR_GETAUTOCONN,iNum); // UTF16
или (через функцию-псевдоним)
int iNum= … // Номер связи "основная-вспомогательная" RDSXCSTR strName=rdsGetObjectStr(Vars,RDS_HVAR_GETAUTOCONN,iNum); // Кодировка по умолчанию
Параметры и результат
- Vars (RDS_HOBJECT)
- Идентификатор вспомогательного объекта-редактора переменных, ранее созданного функцией rdsVSCreateEditor.
- iNum (int)
- Целое число – номер связи переменных.
- strName (RDSCSTR, RDSWCSTR, RDSXCSTR)
- Указатель на строку во внутренней памяти RDS, в которой записано имя вспомогательной переменной, или NULL, если связи с номером iNum нет в объекте Vars.
Примечания
Эта команда возвращает указатель на строку с именем вспомогательной переменной, задействованной в связи с номером iNum. Строка находится во внутренней памяти объекта Vars, этим указателем можно пользоваться только до тех пор, пока содержимое объекта не будет изменено. Связи основных и вспомогательных переменных создаются функцией rdsVSAddAutoConn, общее число таких связей можно узнать при помощи команды RDS_HVAR_GETAUTOCOUNT.
Использование связей вспомогательных переменных с основными в моделях блоков описывается в §2.5.7 и §2.5.8 руководства программиста.
См. также
rdsVSCreateEditor, rdsGetObjectStr, rdsVSAddAutoConn, rdsVSFindAutoConn, RDS_HVAR_GETAUTOMAIN, RDS_HVAR_GETAUTOCOUNT.