Приложения

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

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

А.5.9. Работа со слоями

А.5.9.3. rdsGetLayerId – идентификатор слоя по имени

Функция rdsGetLayerId возвращает идентификатор слоя в указанной подсистеме по его имени.

  int RDSCALL rdsGetLayerIdA(
    RDS_BHANDLE System, // Подсистема
    RDSCSTR LayerName   // Имя слоя (UTF8)
  );
  int RDSCALL rdsGetLayerIdW(
    RDS_BHANDLE System, // Подсистема
    RDSWCSTR LayerName  // Имя слоя (UTF16)
  );
  // Функция-псевдоним
  int RDSCALL rdsGetLayerId(
    RDS_BHANDLE System, // Подсистема
    RDSXCSTR LayerName  // Имя слоя (кодировка по умолчанию)
  );

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

RDS_IBhS (для UTF8) или RDS_IBhWs (для UTF16)

Параметры

System (RDS_BHANDLE)

Идентификатор подсистемы.

LayerName (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку (char* или wchar_t*, в зависимости от версии функции) с именем слоя.

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

Уникальный идентификатор слоя с именем LayerName, или −1, если слоя с таким именем нет в подсистеме System.

Примечания

Имена слоев чувствительны к регистру: «Слой 1» и «слой 1» будут считаться разными слоями.

См. также

rdsGetLayerName, rdsGetLayerParams.