getpeername

getpeername retrieves the IP address and port of the peer connected to the specified socket.

Syntax

int getpeername(
    [in]        SOCKET s,
    [out]       struct sockaddr *name,
    [in, out]   int *namelen
);

Parameters

[in] s

The socket descriptor.

[out] name

A pointer to a socket address structure that receives the address of the peer.

[in, out] namelen

A pointer to an integer that defines the size of the socket address structure indicated by name. Upon return, namelen shall contain the actual size in bytes of name.

Return Value

If the function succeeds, it returns 0 (zero). If the function fails, it returns SOCKET_ERROR. Call WSAGetLastError to retrieve a specific error code.

Requirements