Приложения

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

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

А.5.13. Вызов функций блоков

А.5.13.3. Макрос RDS_FUNCPROVIDERLINK_SUCCESS – проверка успешности подписки на исполнителя функции

Макрос RDS_FUNCPROVIDERLINK_SUCCESS предназначен для проверки успешности подписки на идентификатор блока-исполнителя функции (регистрация блоков-исполнителей и подписка на них подробно рассмотрены в §2.13.6 руководства программиста).

  RDS_FUNCPROVIDERLINK_SUCCESS(
    pLink    // Указатель на RDS_FUNCPROVIDERLINK
  )

Определение

  #define RDS_FUNCPROVIDERLINK_SUCCESS(pLink) \
    ( ((pLink)!=NULL) && \
    (((RDS_PFUNCPROVIDERLINK)(pLink))->Block!=NULL) )

Параметр

pLink (указатель на RDS_FUNCPROVIDERLINK)

Указатель на структуру подписки на идентификатор блока-исполнителя RDS_FUNCPROVIDERLINK.

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

TRUE – блок-исполнитель найден, FALSE – подписка невозможна или в схеме нет блока-исполнителя данной функции.

Примечания

В параметре макроса передается указатель на структуру RDS_FUNCPROVIDERLINK, созданную функцией rdsSubscribeToFuncProvider. Значение, возвращаемое макросом, указывает на возможность вызова блока-исполнителя. На практике, в большинстве случаев, в применении этого макроса нет острой необходимости – эту проверку можно выполнить вручную.

См. также

RDS_FUNCPROVIDERLINK, rdsSubscribeToFuncProvider.