CAsyncSocket::GetPeerName

telefonar Essa função de membro para obter o endereço do serviço de mesmo nível de soquete para que esse soquete está conectado.

BOOL GetPeerName(
   CString& rPeerAddress,
   UINT& rPeerPort 
);
BOOL GetPeerName(
   SOCKADDR* lpSockAddr,
   int* lpSockAddrLen 
);

Parâmetros

  • rPeerAddress
    Referência a um CString objeto que recebe um endereço IP numérico pontilhado.

  • rPeerPort
    Referência a um UINT que armazena uma porta.

  • lpSockAddr
    Um ponteiro para o SOCKADDRestrutura de recebe o nome do soquete de mesmo nível.

  • lpSockAddrLen
    Um ponteiro para o tamanho de endereço em lpSockAddr em bytes. No retorno, o lpSockAddrLen argumento contém o dimensionar real do lpSockAddr retornado em bytes.

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário, 0, e um código de erro específico pode ser recuperado chamando GetLastError.Os seguintes erros se aplicam a essa função de membro:

  • WSANOTINITIALISED   Um bem-sucedida AfxSocketInit deve ocorrer antes de usar essa API.

  • WSAENETDOWN   A implementação do Windows Sockets detectou que o subsistema de rede falhou.

  • WSAEFAULT   The lpSockAddrLen o argumento não é grande o suficiente.

  • WSAEINPROGRESS   Uma telefonar de bloqueio de Windows Sockets está em andamento.

  • WSAENOTCONN   O soquete não está conectado.

  • WSAENOTSOCK   O descritor não é um soquete.

Comentários

Para lidar com endereços IPv6, use CAsyncSocket::GetPeerNameEx.

Requisitos

Cabeçalho: afxsock.h

Consulte também

Referência

Classe CAsyncSocket

Gráfico de hierarquia

CAsyncSocket::Bind

CAsyncSocket::conectar

CAsyncSocket::criar

CAsyncSocket::GetSockName

Outros recursos

CAsyncSocket membros