Partilhar via


CAsyncSocket::GetPeerName

Chamar essa função de membro para obter o endereço de soquete de soquete este ponto no qual está conectado.

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

Parâmetros

  • rPeerAddress
    Referência a um objeto de CString que recebe um endereço IP pontilhada de números.

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

  • lpSockAddr
    Um ponteiro para a estrutura de SOCKADDR que recebe o nome de soquete de ponto.

  • lpSockAddrLen
    Um ponteiro ao comprimento do endereço em lpSockAddr em bytes. O retorno, o argumento de lpSockAddrLen contém o tamanho real de lpSockAddr retornado em bytes.

Valor de retorno

Diferente de zero se a função é com êxito; se não 0, e um código de erro específico podem ser recuperados chamando GetLastError. Os seguintes erros se aplicam a essa função de membro:

  • WSANOTINITIALISED A AfxSocketInit com êxito deve ocorrer antes de usar este API.

  • WSAENETDOWN a implementação da do windows detectou que o subsistema de rede falhou.

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

  • A chamada da do windows de bloqueio deWSAEINPROGRESS A está em andamento.

  • WSAENOTCONN o soquete não está conectado.

  • WSAENOTSOCK o descritor não for um soquete.

Comentários

Para manipular endereços IPV6, use CAsyncSocket::GetPeerNameEx.

Requisitos

Cabeçalho: afxsock.h

Consulte também

Referência

Classe CAsyncSocket

Gráfico da hierarquia

CAsyncSocket::Bind

CAsyncSocket::Connect

CAsyncSocket::Create

CAsyncSocket::GetSockName