HALCON Website / HALCON Operator-Referenz / System / Sockets
KlassenKlassenKlassenKlassen | | | | Operatoren

open_socket_connectopen_socket_connectOpenSocketConnectopen_socket_connectOpenSocketConnectOpenSocketConnect (Operator)

Name

open_socket_connectopen_socket_connectOpenSocketConnectopen_socket_connectOpenSocketConnectOpenSocketConnect — Öffnen einer Socket-Verbindung zu einem bestehenden Socket.

Signatur

open_socket_connect( : : HostName, Port, GenParamName, GenParamValue : Socket)

Herror open_socket_connect(const char* HostName, const Hlong Port, const char* GenParamName, const char* GenParamValue, Hlong* Socket)

Herror T_open_socket_connect(const Htuple HostName, const Htuple Port, const Htuple GenParamName, const Htuple GenParamValue, Htuple* Socket)

Herror open_socket_connect(const HTuple& HostName, const HTuple& Port, const HTuple& GenParamName, const HTuple& GenParamValue, Hlong* Socket)

void HSocket::OpenSocketConnect(const HTuple& HostName, const HTuple& Port, const HTuple& GenParamName, const HTuple& GenParamValue)

void OpenSocketConnect(const HTuple& HostName, const HTuple& Port, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* Socket)

void HSocket::HSocket(const HString& HostName, Hlong Port, const HTuple& GenParamName, const HTuple& GenParamValue)

void HSocket::HSocket(const HString& HostName, Hlong Port, const HString& GenParamName, const HString& GenParamValue)

void HSocket::HSocket(const char* HostName, Hlong Port, const char* GenParamName, const char* GenParamValue)

void HSocket::OpenSocketConnect(const HString& HostName, Hlong Port, const HTuple& GenParamName, const HTuple& GenParamValue)

void HSocket::OpenSocketConnect(const HString& HostName, Hlong Port, const HString& GenParamName, const HString& GenParamValue)

void HSocket::OpenSocketConnect(const char* HostName, Hlong Port, const char* GenParamName, const char* GenParamValue)

void HOperatorSetX.OpenSocketConnect(
[in] VARIANT HostName, [in] VARIANT Port, [in] VARIANT GenParamName, [in] VARIANT GenParamValue, [out] VARIANT* Socket)

void HSocketX.OpenSocketConnect(
[in] BSTR HostName, [in] Hlong Port, [in] VARIANT GenParamName, [in] VARIANT GenParamValue)

static void HOperatorSet.OpenSocketConnect(HTuple hostName, HTuple port, HTuple genParamName, HTuple genParamValue, out HTuple socket)

public HSocket(string hostName, int port, HTuple genParamName, HTuple genParamValue)

public HSocket(string hostName, int port, string genParamName, string genParamValue)

void HSocket.OpenSocketConnect(string hostName, int port, HTuple genParamName, HTuple genParamValue)

void HSocket.OpenSocketConnect(string hostName, int port, string genParamName, string genParamValue)

Beschreibung

open_socket_connectopen_socket_connectOpenSocketConnectopen_socket_connectOpenSocketConnectOpenSocketConnect öffnet eine Socket-Verbindung zu einem akzeptierenden Socket auf dem Rechner mit dem Namen HostNameHostNameHostNameHostNameHostNamehostName, der auf dem Port PortPortPortPortPortport nach Verbindungsanfragen horcht.

Mit dem Parameter 'protocol'"protocol""protocol""protocol""protocol""protocol" kann das verwendete Kommunikationsprotokoll spezifiziert werden. Voreingestellt ist das 'HALCON'"HALCON""HALCON""HALCON""HALCON""HALCON" Protokoll ohne festgelegte Adressfamilie. Somit wird entsprechend den aktuellen Netzwerkeinstellungen des Rechners entweder IPv4 oder IPv6 automatisch verwendet. Um eine bestimmte Adressfamilie auszuwählen, muss eine '4' für IPv4 bzw. eine '6' für IPv6 an den Namen des Protokolls angehängt werden. Z.B. bezeichnet 'HALCON4'"HALCON4""HALCON4""HALCON4""HALCON4""HALCON4" eine HALCON Verbindung über IPv4. Mögliche Werte für eine generische Socketkommunikation sind 'UDP'"UDP""UDP""UDP""UDP""UDP" und 'TCP'"TCP""TCP""TCP""TCP""TCP". Auch hier kann eine '4' oder '6' angehängt werden. Auch die Verwendung von IPv4 (z.B. '127.0.0.1') bzw. IPv6 (z.B. '::1') Adressen für 'HostName' legt die verwendete Adressfamilie fest. Beide Kommunikationspartner müssen dasselbe Protokoll verwenden. Der Datenaustausch über generische Sockets erfolgt ausschließlich mit send_datasend_dataSendDatasend_dataSendDataSendData und receive_datareceive_dataReceiveDatareceive_dataReceiveDataReceiveData.

Mit dem generischen Parameter 'timeout'"timeout""timeout""timeout""timeout""timeout" kann ein Timeout für diesen Socket angegeben werden. Er wird in der Einheit Sekunden oder als Zeichenkette 'infinite'"infinite""infinite""infinite""infinite""infinite" angegeben.

Für das 'HALCON'"HALCON""HALCON""HALCON""HALCON""HALCON" Protokoll muss der akzeptierende Socket zuvor in einem anderen HALCON-Prozess mit open_socket_acceptopen_socket_acceptOpenSocketAcceptopen_socket_acceptOpenSocketAcceptOpenSocketAccept erzeugt worden sein. Um eine Verbindung herzustellen, muss der HALCON-Prozess, in dem der akzeptierende Socket läuft, socket_accept_connectsocket_accept_connectSocketAcceptConnectsocket_accept_connectSocketAcceptConnectSocketAcceptConnect aufrufen. Für ein ausführliches Beispiel siehe open_socket_acceptopen_socket_acceptOpenSocketAcceptopen_socket_acceptOpenSocketAcceptOpenSocketAccept.

Bei der Verwendung generischer Sockets kann der Socket, mit dem man sich verbindet, ein beliebiger Socket vom gleichen Protokolltyp sein.

Parallelisierung

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

HostNameHostNameHostNameHostNameHostNamehostName (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Name des Rechners, zu dem die Verbindung aufgebaut werden soll.

Defaultwert: 'localhost' "localhost" "localhost" "localhost" "localhost" "localhost"

PortPortPortPortPortport (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Nummer des Ports.

Wertevorschläge: 3000, 4570

Typischer Wertebereich: 1024 ≤ Port Port Port Port Port port ≤ 65535

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control)  attribute.name(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Namen der generischen Parameter, die für die Socket-Verbindung eingestellt werden sollen.

Defaultwert: []

Werteliste: 'protocol'"protocol""protocol""protocol""protocol""protocol", 'timeout'"timeout""timeout""timeout""timeout""timeout"

GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control)  attribute.name(-array) → HTupleHTupleHTupleVARIANTHtuple (string / real / integer) (string / double / int / long) (HString / double / Hlong) (char* / double / Hlong) (BSTR / double / Hlong) (char* / double / Hlong)

Werte der generischen Parameter, die für die Socket-Verbindung eingestellt werden sollen.

Defaultwert: []

Wertevorschläge: 0, 3.0, 'infinite'"infinite""infinite""infinite""infinite""infinite", 'HALCON'"HALCON""HALCON""HALCON""HALCON""HALCON", 'UDP'"UDP""UDP""UDP""UDP""UDP", 'TCP'"TCP""TCP""TCP""TCP""TCP", 'HALCON4'"HALCON4""HALCON4""HALCON4""HALCON4""HALCON4", 'UDP4'"UDP4""UDP4""UDP4""UDP4""UDP4", 'TCP4'"TCP4""TCP4""TCP4""TCP4""TCP4", 'HALCON6'"HALCON6""HALCON6""HALCON6""HALCON6""HALCON6", 'UDP6'"UDP6""UDP6""UDP6""UDP6""UDP6", 'TCP6'"TCP6""TCP6""TCP6""TCP6""TCP6"

SocketSocketSocketSocketSocketsocket (output_control)  socket_id → HSocket, HTupleHTupleHSocket, HTupleHSocketX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Nummer des Sockets.

Nachfolger

send_imagesend_imageSendImagesend_imageSendImageSendImage, receive_imagereceive_imageReceiveImagereceive_imageReceiveImageReceiveImage, send_regionsend_regionSendRegionsend_regionSendRegionSendRegion, receive_regionreceive_regionReceiveRegionreceive_regionReceiveRegionReceiveRegion, send_tuplesend_tupleSendTuplesend_tupleSendTupleSendTuple, receive_tuplereceive_tupleReceiveTuplereceive_tupleReceiveTupleReceiveTuple, send_datasend_dataSendDatasend_dataSendDataSendData, receive_datareceive_dataReceiveDatareceive_dataReceiveDataReceiveData

Siehe auch

open_socket_acceptopen_socket_acceptOpenSocketAcceptopen_socket_acceptOpenSocketAcceptOpenSocketAccept, socket_accept_connectsocket_accept_connectSocketAcceptConnectsocket_accept_connectSocketAcceptConnectSocketAcceptConnect, get_socket_paramget_socket_paramGetSocketParamget_socket_paramGetSocketParamGetSocketParam, set_socket_paramset_socket_paramSetSocketParamset_socket_paramSetSocketParamSetSocketParam, close_socketclose_socketCloseSocketclose_socketCloseSocketCloseSocket

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH