Приложения

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

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

А.5.21. Сетевые функции

А.5.21.5. rdsNetServer – запуск сервера и установка соединения с ним

Функция rdsNetServer делает сервером копию RDS, в которой она вызвана, и устанавливает соединение с указанным каналом передачи данных на этом сервере.

  int RDSCALL rdsNetServerA( 
    int Port,         // Номер порта или -1
    RDSCSTR Channel,  // Имя канала (UTF8)
    BOOL Receive      // Получение данных
  );
  int RDSCALL rdsNetServerW( 
    int Port,         // Номер порта или -1
    RDSWCSTR Channel, // Имя канала (UTF16)
    BOOL Receive      // Получение данных
  );
  // Функция-псевдоним
  int RDSCALL rdsNetServer( 
    int Port,         // Номер порта или -1
    RDSXCSTR Channel, // Имя канала (кодировка по умолчанию)
    BOOL Receive      // Получение данных
  );

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

RDS_IISB (для UTF8) или RDS_IIWsB (для UTF16)

Параметры

Port (int)

Номер порта, который будет использовать запущенный сервер. Для использования номера порта по умолчанию, указанного в настройках RDS, в этом параметре передается −1.

Channel (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку с именем канала передачи данных, связь с которым устанавливается. Если такого канала нет на сервере, он будет создан автоматически.

Receive (BOOL)

TRUE – блок, из модели которого вызвана функция, будет получать данные из канала. FALSE – блок не будет получать данные. Передавать данные блок сможет в любом случае.

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

Идентификатор созданного соединения (он будет использоваться во всех остальных сетевых функциях), или −1, если соединение установить не удалось.

Примечания

Эта функция включает функции сервера в копии RDS, в которую загружена схема с блоком, модель которого вызвала функцию. При этом она устанавливает соединение с каналом Channel этого запущенного сервера. В схеме достаточно иметь всего один блок, вызывающий rdsNetServer, все остальные блоки могут связываться с этим локальным сервером при помощи rdsNetConnect.

Принципы обмена данных по сети и каналы передачи данных подробно рассматриваются в §2.15.1 руководства программиста.

Пример

Пример использования функции rdsNetServer приведен в §2.15.2 руководства программиста.

См. также

rdsNetCloseConnection, rdsNetConnect, RDS_BFM_NETCONNECT.