Приложения

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

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

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

А.5.25.26. Команда RDS_HVAR_GETTYPENAME – получить имя типа всей структуры переменных

Команда RDS_HVAR_GETTYPENAME возвращает имя типа, которое присвоено всей структуре переменных объекта командой RDS_HVAR_SETTYPENAME.

Вызов команды

  RDSCSTR strName=rdsGetObjectStrA(Vars,RDS_HVAR_GETTYPENAME,0); // UTF8

или

  RDSWCSTR strName=rdsGetObjectStrW(Vars,RDS_HVAR_GETTYPENAME,0); // UTF16

или (через функцию-псевдоним)

  RDSXCSTR strName=rdsGetObjectStr(Vars,RDS_HVAR_GETTYPENAME,0); // Кодировка по умолчанию

Параметры и результат

Vars (RDS_HOBJECT)

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

strName (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку во внутренней памяти RDS, в которой записано имя типа всей структуры переменных объекта, или NULL, если структура переменных в объекте Vars пуста.

Примечания

Имя типа структуры используется только при регистрации структуры переменных объекта Vars в общем списке структур RDS вызовом rdsVSInstallStruct – именно под этим именем структура регистрируется в списке. Строка, указатель на которую возвращает команда RDS_HVAR_GETTYPENAME, находится во внутренней памяти объекта, этим указателем можно пользоваться только до тех пор, пока содержимое объекта не будет изменено.

См. также

rdsVSCreateEditor, rdsGetObjectStr, RDS_HVAR_SETTYPENAME, rdsVSInstallStruct.