Previous Topic: GETPEERNAMENext Topic: GETSERVBYNAME


Parameters

Parameter

Description

socket-descriptor

Specifies the name of a fullword field containing the socket descriptor from which to retrieve the peer name.

sockaddr

Specifies the name of an area in which to return the sockaddr structure of the peer. The format of this structure depends on the domain of the corresponding socket. This parameter can be assigned to NULL if the caller is not interested in the peer's address.

sockaddr-length

Specifies the name of a fullword field containing the length of sockaddr. If SOCKADDR is assigned to NULL, sockaddr-length must be 0. On return, sockaddr-length contains the size required to represent the peer. If the size of sockaddr is too small to contain the full sockaddr structure, it is truncated.

The maximum value for this parameter is 4096.