Función de devolución de llamada LPWSPGETPEERNAME (ws2spi.h)

  • Artículo

La función LPWSPGetPeerName obtiene la dirección del mismo nivel al que está conectado un socket.

Sintaxis

LPWSPGETPEERNAME Lpwspgetpeername;

int Lpwspgetpeername(
  [in]      SOCKET s,
  [out]     sockaddr *name,
  [in, out] LPINT namelen,
  [out]     LPINT lpErrno
)
{...}

Parámetros

[in] s

Descriptor que identifica un socket conectado.

[out] name

Puntero a la estructura sockaddr para recibir el nombre del mismo nivel.

[in, out] namelen

En la entrada, puntero a un entero que indica el tamaño de la estructura a la que apunta el nombre, en bytes. En la salida, indica el tamaño del nombre devuelto, en bytes.

[out] lpErrno

Puntero al código de error.

Valor devuelto

Si no se produce ningún error, LPWSPGetPeerName devuelve cero. De lo contrario, se devuelve un valor de SOCKET_ERROR y hay disponible un código de error específico en lpErrno.

Código de error Significado
WSAENETDOWN
 Error en el subsistema de red.
WSAEFAULT
 El nombre o el parámetro namelen no es una parte válida del espacio de direcciones del usuario o el parámetro namelen es demasiado pequeño.
WSAEINPROGRESS
 La función se invoca cuando una devolución de llamada está en curso.
WSAENOTSOCK
 El descriptor no es un socket.
WSAENOTCONN
 socket no conectado.
WSAENOTSOCK
 El descriptor no es un socket.

Comentarios

La función LPWSPGetPeerName proporciona el nombre del mismo nivel conectado al socket s y lo almacena en la estructura sockaddr a la que se hace referencia por nombre. Solo se puede usar en un socket conectado. En el caso de los sockets de datagrama, solo se devolverá el nombre de un par especificado en una llamada LPWSPConnect anterior y no se devolverá ningún nombre especificado por una llamada LPWSPSendTo anterior por LPWSPGetPeerName.

Cuando se devuelve, el parámetro namelen contiene el tamaño real del nombre devuelto en bytes.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado ws2spi.h

Consulte también

LPWSPBind

LPWSPGetSockName

LPWSPSocket