Приложения

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

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

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

А.5.21.3. rdsNetConnect – установка сетевого соединения

Функция rdsNetConnect устанавливает соединение с указанным каналом передачи данных на указанном сервере.

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

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

RDS_ISISB (для UTF8) или RDS_IWsIWsB (для UTF16)

Параметры

Host (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку с именем или IP-адресом сервера. IP-адрес указывается в виде строки, например, «192.168.0.1». Если нужно установить соединение с сервером по умолчанию, указанным в настройках RDS, в этом параметре передается NULL.
Port (int): Номер порта на сервере. Для использования номера порта по умолчанию, указанного в настройках RDS, в этом параметре передается −1.
Channel (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку с именем канала передачи данных, связь с которым устанавливается. Если такого канала нет на сервере, он будет создан автоматически.
Receive (BOOL): TRUE – блок, из модели которого вызвана функция, будет получать данные из канала. FALSE – блок не будет получать данные. Передавать данные блок сможет в любом случае.

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

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

Примечания

Эта функция устанавливает соединение с каналом Channel сервера Host (сервер использует для подключений порт Port). Соединение устанавливается не сразу, об успешной его установке сигнализирует событие RDS_BFM_NETCONNECT. Если сервер с адресом Host недоступен, RDS будет повторять попытки соединения до тех пор, пока они не увенчаются успехом, либо пока соединение не будет разорвано вызовом rdsNetCloseConnection.

Если необходимо сделать сервером ту копию RDS, в которую загружена схема, модель блока которой вызвана в данный момент, следует воспользоваться функцией rdsNetServer.

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

Пример

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

См. также

rdsNetCloseConnection, rdsNetServer, RDS_BFM_NETCONNECT.