TlsNetworkSocket Methods

DICOM Connectivity Framework V3.4

The TlsNetworkSocket type exposes the following members.


Public methodAccept
Overridden server-side accept of an incoming connect request.
(Overrides TcpNetworkSocket.Accept.)
Public methodClose
Close the socket
(Overrides TcpNetworkSocket.Close.)
Public methodClose(Int32)
Close the socket with a timeout in seconds
(Overrides TcpNetworkSocket.Close(Int32).)
Public methodConnect(EndPoint)
Connect the socket to the given TCP endpoint
(Overrides TcpNetworkSocket.Connect(EndPoint).)
Public methodConnect(IPAddress, Int32)
Connect the socket to the given IP address and port
(Overrides TcpNetworkSocket.Connect(IPAddress, Int32).)
Public methodConnect(String, Int32)
Connect the socket to the given host and port
(Overrides TcpNetworkSocket.Connect(String, Int32).)
Public methodInitClientTlsConnectionAndAuthenticate
This method should be called to authenticate the TLS stream as a client.
Public methodInitServerTlsConnectionAndAuthenticate
This method should be called to authenticate the TLS stream as a server. For a server side TlsNetworkSocket, when LAZY_SERVER_SIDE_AUTHENTICATION_MODE is false, this method is called when DCF's calls waitForServerConnection() which then calls this instance's Accept() method. In this situation, the AssociationManager will not accept more connections until this method has completed. This method may not complete quickly, for example, if the client side does not send authentication information such as a TLS Client Hello message, which will happen if a non-TLS client connects to the SCP's TLS port. Such a situation can lead to unacceptable delays (waiting for a timeout) in accepting future associations. For a server, when LAZY_SERVER_SIDE_AUTHENTICATION_MODE is true, this method is called by AssociationManager.HandleAssociation() in a new thread, after waitForServerConnection() has completed calling Accept(). Therefore, future connections are not blocked waiting for this method to complete. Note that a consequence of handling the authentication in this manner is that the DCF AssociationManager has incremented its association count to handle this in a new thread. In case of a bad connection request, that association counter will not be decremented until a timeout or other error completes the thread's operation.
Public methodListen
Enter the listen state with the backlog queue length
(Overrides TcpNetworkSocket.Listen(Int32).)
Public methodPoll
Invoke a poll on the socket with microseconds timeout and selected mode
(Overrides TcpNetworkSocket.Poll(Int32, SelectMode).)
Public methodReceive
Read data from the socket into the buffer at offset limited to count bytes
(Overrides TcpNetworkSocket.Receive(Byte, Int32, Int32).)
Public methodSend(Byte)
Write the buffer data to the connected socket
(Overrides TcpNetworkSocket.Send(Byte).)
Public methodSend(Byte, Int32, Int32)
Write the buffer data to the connected socket starting at offset bytes and limited to count bytes
(Overrides TcpNetworkSocket.Send(Byte, Int32, Int32).)
See Also