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