Приложения

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