CAsyncSocket::GetSockName

telefonar Essa função de membro para obter o nome do local para um soquete.

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

Parâmetros

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

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

  • lpSockAddr
    Um ponteiro para um SOCKADDRestrutura de recebe o endereço do soquete.

  • lpSockAddrLen
    Um ponteiro para o tamanho de endereço em lpSockAddr 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 operação de bloqueio de Windows Sockets está em andamento.

  • WSAENOTSOCK   O descritor não é um soquete.

  • WSAEINVAL   O soquete não foi limite a um endereço com BIND.

Comentários

Essa telefonar é especialmente útil quando um Conectar-se telefonar tiver sido feita sem fazer um BIND primeiro; essa telefonar fornece os meios somente por meio da qual você pode determinar a associação de local que foi definida pelo sistema.

Para lidar com endereços IPv6, use CAsyncSocket::GetSockNameEx

Requisitos

Cabeçalho: afxsock.h

Consulte também

Referência

Classe CAsyncSocket

Gráfico de hierarquia

CAsyncSocket::Bind

CAsyncSocket::criar

CAsyncSocket::GetPeerName

Outros recursos

CAsyncSocket membros