Classe CSocketAddr

Essa classe fornece métodos para converter nomes de host em endereços de host, dando suporte a formatos IPv4 e IPV6.

Sintaxe

class CSocketAddr

Membros

Construtores públicos

Nome Descrição
CSocketAddr::CSocketAddr O construtor.

Métodos públicos

Nome Descrição
CSocketAddr::FindAddr Chame esse método para converter o nome de host fornecido para o endereço do host.
CSocketAddr::FindINET4Addr Chame esse método para converter o nome do host IPv4 para o endereço do host.
CSocketAddr::FindINET6Addr Chame esse método para converter o nome do host IPv6 para o endereço do host.
CSocketAddr::GetAddrInfo Chame esse método para retornar um ponteiro para um elemento específico na addrinfo lista.
CSocketAddr::GetAddrInfoList Chame esse método para retornar um ponteiro para a addrinfo lista.

Comentários

essa classe fornece uma abordagem independente de versão de IP para pesquisar endereços de rede para uso com funções de API de Windows sockets e invólucros de soquete em bibliotecas.

Os membros dessa classe que são usados para pesquisar endereços de rede usam a função de API do Win32 Getaddrinfo. A versão ANSI ou UNICODE da função é chamada dependendo se o código é compilado para ANSI ou UNICODE.

Essa classe dá suporte a endereços de rede IPv4 andIPv6.

Requisitos

Cabeçalho: atlsocket. h

CSocketAddr::CSocketAddr

O construtor.

CSocketAddr();

Comentários

Cria um novo CSocketAddr objeto e inicializa a lista vinculada que contém informações de resposta sobre o host.

CSocketAddr::FindAddr

Chame esse método para converter o nome de host fornecido para o endereço do host.

int FindAddr(
    const TCHAR *szHost,
    const TCHAR *szPortOrServiceName,
    int flags,
    int addr_family,
    int sock_type,
    int ai_proto);

int FindAddr(
    const TCHAR *szHost,
    int nPortNo,
    int flags,
    int addr_family,
    int sock_type,
    int ai_proto);

Parâmetros

szHost
O nome do host ou o endereço IP pontilhado.

szPortOrServiceName
O número da porta ou o nome do serviço no host.

nPortNo
O número da porta.

sinalizadores
0 ou combinação de AI_PASSIVE, AI_CANONNAME ou AI_NUMERICHOST.

addr_family
Família de endereços (como PF_INET).

sock_type
Tipo de soquete (como SOCK_STREAM).

ai_proto
Protocolo (como IPPROTO_IP ou IPPROTO_IPV6).

Valor Retornado

Retornará zero se o endereço for calculado com êxito. retorna um código de erro de soquete de Windows diferente de zero em caso de falha. Se for bem-sucedido, o endereço calculado será armazenado em uma lista vinculada que pode ser referenciada usando CSocketAddr::GetAddrInfoList o e CSocketAddr::GetAddrInfo o.

Comentários

O parâmetro de nome de host pode estar no formato IPv4 ou IPv6. Esse método chama a função de API do Win32 Getaddrinfo para executar a conversão.

CSocketAddr::FindINET4Addr

Chame esse método para converter o nome do host IPv4 para o endereço do host.

int FindINET4Addr(
    const TCHAR *szHost,
    int nPortNo,
    int flags = 0,
    int sock_type = SOCK_STREAM);

Parâmetros

szHost
O nome do host ou o endereço IP pontilhado.

nPortNo
O número da porta.

sinalizadores
0 ou combinação de AI_PASSIVE, AI_CANONNAME ou AI_NUMERICHOST.

sock_type
Tipo de soquete (como SOCK_STREAM).

Valor Retornado

Retornará zero se o endereço for calculado com êxito. retorna um código de erro de soquete de Windows diferente de zero em caso de falha. Se for bem-sucedido, o endereço calculado será armazenado em uma lista vinculada que pode ser referenciada usando CSocketAddr::GetAddrInfoList o e CSocketAddr::GetAddrInfo o.

Comentários

Esse método chama a função de API do Win32 Getaddrinfo para executar a conversão.

CSocketAddr::FindINET6Addr

Chame esse método para converter o nome do host IPv6 para o endereço do host.

int FindINET6Addr(
    const TCHAR *szHost,
    int nPortNo,
    int flags = 0,
    int sock_type = SOCK_STREAM);

Parâmetros

szHost
O nome do host ou o endereço IP pontilhado.

nPortNo
O número da porta.

sinalizadores
0 ou combinação de AI_PASSIVE, AI_CANONNAME ou AI_NUMERICHOST.

sock_type
Tipo de soquete (como SOCK_STREAM).

Valor Retornado

Retornará zero se o endereço for calculado com êxito. retorna um código de erro de soquete de Windows diferente de zero em caso de falha. Se for bem-sucedido, o endereço calculado será armazenado em uma lista vinculada que pode ser referenciada usando CSocketAddr::GetAddrInfoList o e CSocketAddr::GetAddrInfo o.

Comentários

Esse método chama a função de API do Win32 Getaddrinfo para executar a conversão.

CSocketAddr::GetAddrInfo

Chame esse método para retornar um ponteiro para um elemento específico na addrinfo lista.

addrinfo* const GetAddrInfo(int nIndex = 0) const;

Parâmetros

nIndex
Uma referência a um elemento específico na lista addrinfo .

Valor Retornado

Retorna um ponteiro para a addrinfo estrutura referenciada por nIndex na lista vinculada que contém informações de resposta sobre o host.

CSocketAddr::GetAddrInfoList

Chame esse método para retornar um ponteiro para a addrinfo lista.

addrinfo* const GetAddrInfoList() const;

Valor Retornado

Ponteiro para uma lista vinculada de uma ou mais estruturas addrinfo que contêm informações de resposta sobre o host. Para obter mais informações, consulte estrutura addrinfo.

Confira também

Visão geral da classe