Admin: 1 revision imported

2021-11-20T17:07:21Z

1 revision imported

1>Admin at 17:42, 10 November 2021

2021-11-10T17:42:14Z

Admin: 1 revision imported

2021-02-07T06:51:19Z

1 revision imported

Admin at 07:20, 24 April 2020

2020-04-24T07:20:17Z

New page

{{infobox function
|name=ConnectUSR1
|object=[[Объект IP]]
|caption=Установка соединения
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект IP]]}}
Функция производит соединение TCP/IP с удаленным сервером по внутреннему протоколу системы. После соединения, обычно следующим шагом является объявление [[USR1 протокол|протокола USR1]]. При установке соединения всегда используется неблокирующий режим сокета, режим может быть изменен сразу после соединения с помощью атрибута [[IPConnection.IsBlocking|IsBlocking]].

== Синтаксис ==
<code>
{{Grey|IPConnection.}}'''ConnectUSR1'''(''<Адрес соединения (STRING)>'',''<Пароль USR1 соединения (STRING)>''{{Optional|,<Тип соединения (INT)>{{Default|{{Eq}}0}}}}):''<Новое соединение или пустое значение (IPOBJECT)>''
</code>

==== Аргументы ====
* <code>''<Адрес соединения (STRING)>''</code> - Адрес соединения задается в виде <code><Доменное имя сервера, адрес IPv4 или IPv6>[:<Номер порта>]</code> (примеры: <code>127.0.0.1:80</code>, <code>en.wikipedia.org:443</code>, <code>москва.рф:443</code>, <code>::1=80</code>). При указании IP адреса (<code>xxx.xxx.xxx.xxx</code> или <code>xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx</code>), можно использовать квадратные скобки '''[''', ''']''' для отделения IP адреса от номера порта. Номер порта можно указывать после знака ''':''' или знака '''=''', для IPv6 адресов можно использовать только знак '''=''' или использовать квадратные скобки, как разделитель, так как ''':''' занят для указания элементов адреса (примеры: <code>127.0.0.1=80</code>, <code>[::1]:443</code>). Если номер порта в адресе не задан, используется порт 13251. Доменное имя будет автоматически закодировано в формат Punycode, если в нем присутствуют международные символы.
* <code>''<Пароль USR1 соединения (STRING)>''</code> - Аргумент задает пароль для соединения, международные символы не поддерживаются, длина пароля может быть произвольной.
* <code>''<Тип соединения (INT)>''</code> - {{Optional}} Указывает на тип (протокол) соединения. Нужно заметить, что если аргумент ''адрес соединения'' использует нотацию IPv6 или доменное имя возвратит только IPv6 адрес (у сервера отсутствует IPv4 адрес), значение этого аргумента будет проигнорировано и будет использован протокол IPv6, и наоборот, если тип соединения подразумевает IPv6, однако можно осуществить соединение только на IPv4, аргумент будет проигнорирован. Чтобы узнать, по какому протоколу осуществлено соединение, можно использовать атрибут [[IPConnection.IsIPv6|IsIPv6]]. Доступны следующие значения аргумента:
** '''0''' (по умолчанию) -- Будет использован протокол IPv4
** '''1''' -- Будет использован протокол IPv6

==== Возвращаемое значение ====
Возвращается новый объект IP. В случае, если соединение было успешным, объект соединен, иначе объект пустой.

== Примеры ==
<pre>
//Пример соединения и инициации протокола USR1
Сокет:=IPConnection.ConnectUSR1(Сервер,Пароль);
If Сокет.IsConnected() Then
If not Сокет.SendCmd("USR1") Then
Message("Сервер не принял режим USR1 (1)!","!");
Exit 0;
EndIf;
Комм:=Сокет.ReceiveCmd();
If Комм="BUSY" Then
Message("Сервер занят!","!");
Exit 0;
EndIf;
If Комм<>"OK " Then
Message("Сервер не принял режим USR1 (2)!","!");
Exit 0;
EndIf;
...
EndIf;
</pre>

← Older revision	Revision as of 17:07, 20 November 2021
(No difference)

@@ Line 17: / Line 17: @@
 == Синтаксис ==
 <code>
-{{Grey|IPConnection.}}'''ConnectUSR1'''(''<Адрес соединения (STRING)>'',''<Пароль USR1 соединения (STRING)>''{{Optional|,<Тип соединения (INT)>{{Default|{{Eq}}0}}}}):''<Новое соединение или пустое значение (IPOBJECT)>''
+{{Grey|IPConnection.}}'''ConnectUSR1'''(''<Адрес соединения (STRING)>'',''<Пароль USR1 соединения (STRING)>''{{Optional|,<Тип соединения (INT)>{{Default|{{Eq}}0}}}}):''<Новое соединение (IPOBJECT)>''
 </code>
@@ Line 28: / Line 28: @@
 ==== Возвращаемое значение ====
-Возвращается новый объект IP. В случае, если соединение было успешным, объект соединен, иначе объект пустой.
+Возвращается новый объект IP. В случае, если соединение было успешным, объект соединен, иначе объект неактивен.
 == Примеры ==

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)

IPConnection.ConnectUSR1 - Revision history

Admin: 1 revision imported

1>Admin at 17:42, 10 November 2021

Admin: 1 revision imported

Admin at 07:20, 24 April 2020