Function SocketBind() | Xbase++

Associates a local address with a socket.

SocketBind( <nSocket>         , ;
            [<nAddressFamily>], ;
            <xLocalAddress    , ;
            <nPort>           , ;
            [@<nError>]         ) --> lSuccess

This is a numeric socket descriptor previously created with SocketNew() or SocketCreate().

This parameter specifies the adress family to which the socket belongs to. Windows only supports the #define constant AF_INET as value, which is the default.

The local address can be specified either as a numeric address in network byte order, or as a character string. The latter can be coded as the DNS name of the computer or as IP address in form of a dotted octet string.

<nPort>

This is the numeric port number on the local computer to bind the socket to. When the numeric value 0 is passed in the parameter <nPort>, the socket is bound to a port from the dynamic port range. In this case, the number of the bound port can be retrieved using the function SocketGetSockName().

If this parameter is passed by reference to the function, it gets assigned a numeric error code when the function fails. #define constants beginning with WSAE are available in the file SOCKET.CH to identify an error condition.

The function returns .T. (true) if the socket is bound successfully, otherwise .F. (false) is returned.

A socket is created without a name. Unless a name is bound to a socket, there is no way for other processes to reference it and, as a consequence, no data may be received on it. SocketBind() binds an unconnected stream or datagram socket to a name so that the local part of a socket association is defined.

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.

Function SocketBind() Professional