Related Concepts	Other Library Functions

function

TCPServiceGetPort

Library: omtcp - TCP/IP client and server support Include: omtcp.xin

Return type: Integer Returns:        The service port number the TCP service object listens to for an incoming connection.

Declaration

  define external integer function TCPServiceGetPort
        value TCPService this-TCPService
  as TCPServiceGetPort

Purpose

This function is used to learn which service port number the TCP service object listens to for incoming connections. This API is particularly useful when you call TCPServiceOpen without stating a port number explicitly. In this case, TCPServiceOpen chooses an available port, and TCPServiceGetPort can then be used to learn about the chosen port.

Argument:

• "this-TCPService" is an opaque object of type TCPService

Example

  local TCPService omdemo-service
  local integer port

  set omdemo-service to TCPServiceOpen
  set port to TCPServiceGetPort omdemo-service
  output "The selected service port for omdemo-service is %d(port)%n"

Related Concepts    Security considerations

Other Library Functions    TCPConnectionClose    TCPConnectionGetCharacters    TCPConnectionGetLine    TCPConnectionGetOutput    TCPConnectionGetPeerIP    TCPConnectionGetPeerName    TCPConnectionGetSource    TCPConnectionGetStatusReport    TCPConnectionHasCharactersToRead    TCPConnectionIsConnected    TCPConnectionIsInError    TCPConnectionOpen    TCPConnectionPut    TCPConnectionSetBuffering    TCPConnectionSignalSourceEnd    TCPIsVersionCompatible    TCPLibraryVersion    TCPServiceAcceptConnection    TCPServiceClose    TCPServiceGetPort    TCPServiceGetStatusReport    TCPServiceIsInError    TCPServiceIsOpen    TCPServiceOpen    TCPTraceConnectionOpen

----

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ OMX ] [ OMX ] [ ERRORS ]

Copyright © OmniMark Technologies Corporation, 1988-2000.