Приложения

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

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

А.5.35. Функции поддержки автоматической компиляции моделей

А.5.35.7. rdscompLinkAvailableModule – найти и привязать совместимый модуль

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

  BOOL RDSCALL rdscompLinkAvailableModuleA(
    RDSCSTR ModelFormat  // Формат модели (UTF8)
  );
  BOOL RDSCALL rdscompLinkAvailableModuleW(
    RDSWCSTR ModelFormat // Формат модели (UTF16)
  );
  // Функция-псевдоним
  BOOL RDSCALL rdscompLinkAvailableModule(
    RDSXCSTR ModelFormat // Формат модели (кодировка по умолчанию)
  );

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

RDS_BS (для UTF8) или RDS_BWs (для UTF16)

Параметр

ModelFormat (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку с идентификатором формата модели. Ее можно считать из поля ModelFormat структуры данных модуля RDS_COMPMODULEDATA.

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

TRUE, если удалось найти модуль, и FALSE в противном случае.

Примечания

Эта функция используется только при создании специального модуля автокомпиляции, предназначенного для поиска других настроенных модулей, в параметрах которых указан заданный формат модели. При этом она должна вызываться в реакции на событие RDS_COMPM_INIT такого модуля. Успешный вызов функции приведет к «привязке» найденного модуля к данному модулю. Все события при этом будут автоматически передаваться найденному модулю, поэтому всю работу по компиляции моделей быдет выполнять он, а не модуль поиска, указанный в параметрах автокомпилируемых блоков.

Пример

Пример использования функции приведен в §3.5 руководства программиста.

См. также

RDS_COMPM_INIT, RDS_COMPMODULEDATA, rdscompLinkModuleAllowed.