Приложения

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

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

А.5.17. Работа с глобальными данными схемы

А.5.17.4. rdsSGPRegisterName – регистрация имени глобального параметра

Функция rdsSGPRegisterName регистрирует в RDS имя глобального параметра схемы и возвращает целый ненулевой идентификатор, по которому к этому параметру можно будет в дальнейшем обращаться.

  int RDSCALL rdsSGPRegisterNameA( 
    RDSCSTR Name  // Имя глобального параметра (UTF8)
  );
  int RDSCALL rdsSGPRegisterNameW( 
    RDSWCSTR Name // Имя глобального параметра (UTF16)
  );
  // Функция-псевдоним
  int RDSCALL rdsSGPRegisterName( 
    RDSXCSTR Name // Имя глобального параметра (кодировка по умолчанию)
  );

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

RDS_IS (для UTF8) или RDS_IWs (для UTF16)

Параметры

Name (RDSCSTR, RDSWCSTR, RDSXCSTR)

Имя глобального параметра.

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

Идентификатор зарегистрированного параметра для дальнейших действий с ним.

Примечания

К глобальным параметрам схемы можно обращаться и непосредственно по именам, но поиск параметра по идентификатору выполняется быстрее. При первом обращении к параметру по незарегистрированному имени (например, при помощи функций rdsSGPSetData и rdsSGPGetData) регистрация имени выполняется автоматически.

См. также

rdsSGPSetData, rdsSGPGetData, RDS_SGPDATA.