Compartilhar via


CAsyncSocket::GetSockName

Chamar essa função de membro para obter o nome local para um soquete.

BOOL GetSockName( 
   CString& rSocketAddress, 
   UINT& rSocketPort  
); 
BOOL GetSockName( 
   SOCKADDR* lpSockAddr, 
   int* lpSockAddrLen  
);

Parâmetros

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

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

  • lpSockAddr
    Um ponteiro a estrutura de SOCKADDR que recebe o endereço de soquete.

  • lpSockAddrLen
    Um ponteiro ao comprimento do endereço em lpSockAddr 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 operação de soquetes do windows de bloqueio deWSAEINPROGRESS A está em andamento.

  • WSAENOTSOCK o descritor não for um soquete.

  • WSAEINVAL o soquete não foi associado a um endereço com Ligar.

Comentários

Esta chamada é especialmente útil quando uma chamada de Conectar foi feito sem fazer Ligar primeiro; esta chamada fornece os meios pelo qual você pode determinar a associação local que foi definida pelo sistema.

Para manipular endereços IPV6, use CAsyncSocket::GetSockNameEx

Requisitos

Cabeçalho: afxsock.h

Consulte também

Referência

Classe CAsyncSocket

Gráfico da hierarquia

CAsyncSocket::Bind

CAsyncSocket::Create

CAsyncSocket::GetPeerName