Compartilhar via

Função de retorno de chamada LPWSPGETPEERNAME (ws2spi.h)

  • Artigo

A função LPWSPGetPeerName obtém o endereço do par ao qual um soquete está conectado.

Sintaxe

LPWSPGETPEERNAME Lpwspgetpeername;

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

Parâmetros

[in] s

Descritor que identifica um soquete conectado.

[out] name

Ponteiro para a estrutura sockaddr para receber o nome do par.

[in, out] namelen

Na entrada, ponteiro para um inteiro que indica o tamanho da estrutura apontada por nome, em bytes. Na saída, indica o tamanho do nome retornado, em bytes.

[out] lpErrno

Ponteiro para o código de erro.

Retornar valor

Se nenhum erro ocorrer, LPWSPGetPeerName retornará zero. Caso contrário, um valor de SOCKET_ERROR será retornado e um código de erro específico estará disponível em lpErrno.

Código do Erro Significado
WSAENETDOWN
 O subsistema de rede falhou.
WSAEFAULT
 O nome ou o parâmetro namelen não é uma parte válida do espaço de endereço do usuário ou o parâmetro namelen é muito pequeno.
WSAEINPROGRESS
 A função é invocada quando um retorno de chamada está em andamento.
WSAENOTSOCK
 O descritor não é um soquete.
WSAENOTCONN
 O soquete não está conectado.
WSAENOTSOCK
 O descritor não é um soquete.

Comentários

A função LPWSPGetPeerName fornece o nome do par conectado ao soquete s e armazena-o na estrutura sockaddr referenciada pelo nome. Ele só pode ser usado em um soquete conectado. Para soquetes de datagrama, somente o nome de um par especificado em uma chamada LPWSPConnect anterior será retornado e qualquer nome especificado por uma chamada LPWSPSendTo anterior não será retornado por LPWSPGetPeerName.

No retorno, o parâmetro namelen contém o tamanho real do nome retornado em bytes.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho ws2spi.h

Confira também

LPWSPBind

LPWSPGetSockName

LPWSPSocket