Compartilhar 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 de CAsyncSocket

Gráfico de hierarquia

CAsyncSocket::Bind

CAsyncSocket::Connect

CAsyncSocket::Create

CAsyncSocket::GetSockName