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

Описания RDS

Приложения

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

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

А.5.6. Операции с блоками и связями

А.5.6.28. rdsGetIOBlockByVarName – внешний вход/выход по имени переменной подсистемы

# Приложения

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

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

#### А.5.6. Операции с блоками и связями

##### А.5.6.28. rdsGetIOBlockByVarName – внешний вход/выход по имени переменной подсистемы

Функция rdsGetIOBlockByVarName возвращает идентификатор внутреннего блока-входа или выхода в подсистеме, соответствующего ее переменной с заданным именем.

      RDS_BHANDLE RDSCALL rdsGetIOBlockByVarNameA(
        RDS_BHANDLE Parent,          // Подсистема
        RDSCSTR VarName,             // Имя переменной подсистемы (UTF8)
        RDS_PBLOCKDESCRIPTION pDescr // Заполняемое описание блока
      );
      RDS_BHANDLE RDSCALL rdsGetIOBlockByVarNameW(
        RDS_BHANDLE Parent,          // Подсистема
        RDSWCSTR VarName,            // Имя переменной подсистемы (UTF16)
        RDS_PBLOCKDESCRIPTION pDescr // Заполняемое описание блока
      );
      // Функция-псевдоним
      RDS_BHANDLE RDSCALL rdsGetIOBlockByVarName(
        RDS_BHANDLE Parent,          // Подсистема
        RDSXCSTR VarName,            // Имя переменной подсистемы (кодировка по умолчанию)
        RDS_PBLOCKDESCRIPTION pDescr // Заполняемое описание блока
      );

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

RDS_BhBhSBd (для UTF8) или RDS_BhBhWsBd (для UTF16)

Параметры

Parent(RDS_BHANDLE)
  Идентификатор подсистемы, внутри которой нужно найти внешний вход или выход.
VarName(RDSCSTR,RDSWCSTR,RDSXCSTR)
  Указатель на строку (char* или wchar_t*, в зависимости от версии функции) с именем переменной подсистемы (переменной-входу подсистемы будет соответствовать блок-вход внутри нее, переменной-выходу – блок-выход).
pDescr(RDS_PBLOCKDESCRIPTION)
  Указатель на заполняемую функцией структуру описания найденного внутри подсистемы блока RDS_BLOCKDESCRIPTION. Если вызывающей программе не нужно это описание, в этом параметре можно передать NULL.

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

Идентификатор найденного блока (RDS_BHANDLE) или NULL, если блок не найден (например, если в подсистеме нет переменной с указанным именем).

Примечания

Эта функция ищет в подсистеме Parent внешний вход или внешний выход, связанный с ее переменной с именем VarName. Чаще всего функция используется для прослеживания связей внутрь подсистемы в процессе программного анализа структуры схемы: обнаружив соединение связи с подсистемой, из описания соединительной точки этой связи (RDS_POINTDESCRIPTION) можно узнать имя переменной, к которой подключена связь, а затем, определив с помощью rdsGetIOBlockByVarName внутренний блок подсистемы, соответствующий этой переменной, анализировать связи, идущие от него или к нему внутри подсистемы.

См. также

rdsGetIOBlockLink, rdsGetBlockLink, RDS_BLOCKDESCRIPTION, RDS_POINTDESCRIPTION.