int getsockopt(SOCKET socket, 
               int    level, 
               int    option_name, 
               char * option_value, 
               int  * optionlen);

Parameters

socket

Socket returned by socket.

level

Protocol level. Must be SOL_SOCKET.

option_name

Option to query. See setsockopt for the options supported and the format of option_value for each option.

option_value

Buffer which will contain the value for the requested option.

optionlen

Pointer to length of * option_value.

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 valid.
EINVAL	The parameter level is not valid.
ENOPROTOOPT	Option parameter is invalid or unsupported.
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.

getsockopt extracts the current value for a socket option associated with it. The format of option_value is dependent upon the option retrieving. The length of option_value is passed to this function in optionlen and the actual length of valid information stored in option_value is returned in optionlen.

Left Socket API

Function getsockname

Down Function htonl