[Overview][Constants][Types][Procedures and functions][Index] Reference for unit 'Sockets' (#rtl)

fpgetpeername

Return the name (address) of the connected peer.

Declaration

Source position: socketsh.inc line 172

function fpgetpeername(

  s: cint;

  name: psockaddr;

  namelen: psocklen

):cint;

Description

fpGetPeerName returns the name of the entity connected to the specified socket S. The Socket must be connected for this call to work.

Name should point to enough space to store the name, the amount of space pointed to should be set in Namelen. When the function returns succesfully, Name will be filled with the name, and Name will be set to the length of Name.

Errors

Errors are reported in SocketError, and include the following:

SYS_EBADF
The socket descriptor is invalid.
SYS_ENOBUFS
The system doesn't have enough buffers to perform the operation.
SYS_ENOTSOCK
The descriptor is not a socket.
SYS_EFAULT
Addr points outside your address space.
SYS_ENOTCONN
The socket isn't connected.

See also

fpConnect

  

Open a connection to a server socket.

fpSocket

  

Create new socket
The latest version of this document can be found at lazarus-ccr.sourceforge.net.