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

Описания RDS

Приложения

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

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

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

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

# Приложения

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