Приложения

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

А.4. Структуры RDS

А.4.9. RDS_FINDBYEXTIDDATA – результаты поиска по идентификатору

Структура RDS_FINDBYEXTIDDATA используется в параметрах функции rdsBlockOrConnByExtId, которая ищет в схеме блок или связь по его или ее уникальному целому идентификатору. Такой идентификатор можно получить через поле ExtId структур описания блока RDS_BLOCKDESCRIPTION и связи RDS_CONNDESCRIPTION.

  typedef struct {
    DWORD servSize;    // Размер этой структуры
    BOOL Found;        // Что-то найдено
    RDS_BHANDLE Block; // Найденный блок
    RDS_CHANDLE Conn;  // Найденная связь или шина
    RDSINT32 Type;     // Тип найденного объекта
  } RDS_FINDBYEXTIDDATA;
  typedef RDS_FINDBYEXTIDDATA *RDS_PFINDBYEXTIDDATA;

Поля структуры

servSize (DWORD)

Размер этой структуры в байтах. Перед вызовом сервисной функции rdsBlockOrConnByExtId полю servSize необходимо присвоить значение sizeof(RDS_FINDBYEXTIDDATA).

Found (BOOL)

Найдены блок, связь или шина с указанным в параметре функции целым идентификатором.

Block (RDS_BHANDLE)

Внутренний идентификатор блока, которому принадлежит переданный в параметрах функции целый идентификатор. Практически все сервисные функции RDS работают именно с идентификаторами типа RDS_BHANDLE.

Conn (RDS_CHANDLE)

Внутренний идентификатор связи или шины, которой принадлежит переданный в параметрах функции целый идентификатор. Практически все сервисные функции RDS работают именно с идентификаторами типа RDS_CHANDLE.

Type (RDSINT32)

Тип найденного объекта (одна из стандартных констант типа):

RDS_TUNKNOWN	объект не найден
RDS_BTSYSTEM	подсистема
RDS_BTSIMPLEBLOCK	простой блок
RDS_BTINPUTBLOCK	внешний вход
RDS_BTOUTPUTBLOCK	внешний выход
RDS_BTBUSPORT	ввод шины
RDS_CTCONNECTION	связь
RDS_CTBUS	шина

В результате вызова функции rdsBlockOrConnByExtId в этой структуре будет заполнено либо поле Block, если переданный целый идентификатор принадлежит блоку (в поле Conn при этом будет записано значение NULL), либо поле Conn, если идентификатор принадлежит связи или шине (при этом NULL будет записано в Block). В поле Found будет записано TRUE, если переданный идентификатор принадлежит какому-либо объекту, то есть если либо Conn, либо Block не равны NULL.

См. также

rdsBlockOrConnByExtId, RDS_BLOCKDESCRIPTION, RDS_CONNDESCRIPTION.