getpeername()

Description

Get the address of the peer to which a socket is connected.

#include <winsock.h>

int PASCAL FAR getpeername(SOCKET s, struct sockaddr FAR * name, int FAR * namelen);

s

A descriptor identifying a connected socket.
name
The structure which is to receive the name of the peer.
namelen
A pointer to the size of the name structure.

Remarks

getpeername() retrieves the name of the peer connected to the socket s and stores it in the struct sockaddr identified by name. It is used on a connected datagram or stream socket. On return, the namelen argument contains the actual size of the name returned in bytes.

Return Value

If no error occurs, getpeername() returns 0. Otherwise, a value of SOCKET_ERROR is returned, and a specific error code may be retrieved by calling WSAGetLastError()

Error Codes

WSANOTINITIALISED

A successful WSAStartup() must occur before using this API.
WSAENETDOWN
The Windows Sockets implementation has detected that the network subsystem has failed.
WSAEFAULT
The namelen argument is not large enough.
WSAEINPROGRESS
A blocking Windows Sockets call is in progress.
WSAENOTCONN
The socket is not connected.
WSAENOTSOCK
The descriptor is not a socket.

See Also

bind(), socket(), getsockname()

---

[Back: connect()]
[Next: getsockname()]