Приложения

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

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

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

А.5.9.5. rdsGetLayerName – имя слоя по идентификатору

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

  RDSSTR RDSCALL rdsGetLayerNameA( // UTF8
    RDS_BHANDLE System, // Подсистема
    int LayerId         // Идентификатор слоя
  );
  RDSWSTR RDSCALL rdsGetLayerNameW( // UTF16
    RDS_BHANDLE System, // Подсистема
    int LayerId         // Идентификатор слоя
  );
  // Функция-псевдоним
  RDSXSTR RDSCALL rdsGetLayerName( // Кодировка по умолчанию
    RDS_BHANDLE System, // Подсистема
    int LayerId         // Идентификатор слоя
  );

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

RDS_SBhI (для UTF8) или RDS_WsBhI (для UTF16)

Параметры

System (RDS_BHANDLE)

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

LayerId (int)

Идентификатор слоя.

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

Указатель на строку (char* или wchar_t*, в зависимости от версии функции) с именем слоя или NULL, если слоя с идентификатором LayerId нет в подсистеме System. Строка располагается во внутренней памяти RDS, вызывающая программа не должна ее изменять.

См. также

rdsGetLayerId, rdsGetLayerParams.