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

Описания RDS

Приложения

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

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

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

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

# Приложения

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