Function getsockname

Function htons

Function inet_addr

Function inet_ntoa

Function ioctlsocket

Simplified Networking API

Function getsockname

Returns port number and IP address of the local host.

int getsockname(SOCKET socket, struct sockaddr * addr, int * addrlen);

Parameters

socket

Socket returned by socket.

addr

Returns address of local host (port number and IP address are in network byte order). This parameter has type struct sockaddr * for historical reasons. Use type struct sockaddr_in * instead.

addrlen

size of structure pointed to by addr.

return value

Returns 0 if successful, otherwise SOCKET_ERROR. If an error occurred, call xn_getlasterror and xn_geterror_string to return the error value. Section Error Codes further describes each error. Possible values for this function are:

Value	Meaning
EFAULT	Invalid parameter, i.e. a pointer is NULL or addrlen is not large enough.
ENOTINITIALIZED	RTIP-32 has not been initialized (xn_rtip_init has not been called).
ENOTSOCK	Invalid socket descriptor.
EOPNOTSUPPORT	Socket type not supported for this function.

This function extracts the IP address and port number of the local host of the socket and stores it in *addr. Upon entry, parameter addrlen should contain the size of the addr structure. getsockname sets addrlen to the size of the valid data stored in addr.

Left Socket API

Function getservbyport

Down Function getsockopt