Текущий раздел:

Описания RDS

Приложения

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

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

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

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

# Приложения

## Приложение А. Функции, константы и структуры 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.