Приложения

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

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

А.5.14. Общие функции работы с переменными блока

А.5.14.19. rdsSetRuntimeType – установить фактический тип переменной произвольного типа

Функция rdsSetRuntimeType служит для присвоения переменной произвольного типа какого-либо конкретного фактического типа. Работа с переменными произвольного типа подробно рассматривается в §2.5.6 руководства программиста.

  LPVOID RDSCALL rdsSetRuntimeTypeA(
    LPVOID BaseAddr, // Базовый адрес переменной
    RDSCSTR TypeStr  // Cтрока типа (UTF8)
  );
  LPVOID RDSCALL rdsSetRuntimeTypeW(
    LPVOID BaseAddr, // Базовый адрес переменной
    RDSWCSTR TypeStr // Cтрока типа (UTF16)
  );
  // Функция-псевдоним
  LPVOID RDSCALL rdsSetRuntimeType(
    LPVOID BaseAddr, // Базовый адрес переменной
    RDSXCSTR TypeStr // Cтрока типа (кодировка по умолчанию)
  );

Тип указателя на эту функцию

RDS_pVpVS (для UTF8) или RDS_pVpVWs (для UTF16)

Параметры

BaseAddr (LPVOID): Базовый адрес переменной произвольного типа в дереве, то есть указатель на блок из восьми байтов, которые эта переменная занимает в дереве переменных блока.
TypeStr (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку, описывающую новый фактический тип переменной. Эта строка состоит из одного (для простых переменных) или нескольких (для сложных переменных) стандартных символов, используемых в RDS для указания типов переменных.

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

Указатель на начало области данных новой переменной указанного фактического типа, созданной внутри переменной произвольного типа. Если строка типа пустая, функция вернет NULL.

Примечания

Эта функция позволяет изменять фактический тип переменной произвольного типа. Пример ее использования приведен в §2.5.6 руководства программиста, там же описывается принцип размещения переменных произвольного типа в памяти.

См. также

rdsClearRuntimeType, rdsGetRuntimeTypeData.