Compartilhar via


SOCKADDR_INET union (ws2ipdef.h)

A união SOCKADDR_INET contém um IPv4, um endereço IPv6 ou uma família de endereços.

Sintaxe

typedef union _SOCKADDR_INET {
  SOCKADDR_IN    Ipv4;
  SOCKADDR_IN6   Ipv6;
  ADDRESS_FAMILY si_family;
} SOCKADDR_INET, *PSOCKADDR_INET;

Membros

Ipv4

Tipo: SOCKADDR_IN

Um endereço IPv4 representado como uma estrutura SOCKADDR_IN que contém a família de endereços e o endereço IPv4. A família de endereços está em ordem de byte de host e o endereço IPv4 está em ordem de byte de rede.

Na SDK do Windows lançada para Windows Vista e posterior, a organização dos arquivos de cabeçalho foi alterada e a estrutura de SOCKADDR_IN é definida no arquivo de cabeçalho Ws2def.h. Observe que o arquivo de cabeçalho Ws2def.h é incluído automaticamente no Winsock2.h e nunca deve ser usado diretamente.

Ipv6

Tipo: SOCKADDR_IN6

Um endereço IPv6 representado como uma estrutura SOCKADDR_IN6 que contém a família de endereços e o endereço IPv6. A família de endereços está em ordem de byte de host e o endereço IPv6 está em ordem de byte de rede.

Na SDK do Windows lançada para Windows Vista e posterior, a organização dos arquivos de cabeçalho foi alterada e a estrutura SOCKADDR_IN6 é definida no arquivo de cabeçalho Ws2def.h. Observe que o arquivo de cabeçalho Ws2def.h é incluído automaticamente no Winsock2.h e nunca deve ser usado diretamente.

si_family

Tipo: ADDRESS_FAMILY

A família de endereços.

Os valores possíveis para a família de endereços são listados no arquivo de cabeçalho Ws2def.h . Observe que os valores para a família de endereços AF_ e PF_ constantes da família de protocolos são idênticos (por exemplo, AF_INET e PF_INET), portanto, qualquer constante pode ser usada. O arquivo de cabeçalho Ws2def.h é incluído automaticamente no Winsock2.h e nunca deve ser usado diretamente.

Os valores com suporte no momento são AF_INET, AF_INET6 e AF_UNSPEC.

Valor Significado
AF_UNSPEC
0
A família de endereços não é especificada. Quando esse parâmetro é especificado, a união SOCKADDR_INET pode representar a família de endereços IPv4 ou IPv6.
AF_INET
2
A família de endereços IPv4 (Protocolo de Internet versão 4).
AF_INET6
23
A família de endereços IPv6 (Internet Protocol versão 6).

Comentários

A união SOCKADDR_INET é definida no Windows Vista e posterior.

A união SOCKADDR_INET é uma estrutura de conveniência para acessar um endereço IPv4, um endereço IPv6 ou a família de endereços IP sem precisar converter a estrutura sockaddr .

A união SOCKADDR_INET é o tipo de dados do membro prefixo na estrutura IP_ADDRESS_PREFIX

Observe que o arquivo de cabeçalho Ws2ipdef.h é incluído automaticamente no arquivo de cabeçalho Ws2tcpip.h e nunca deve ser usado diretamente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho ws2ipdef.h (include Ws2tcpip.h)

Confira também

IP_ADDRESS_PREFIX

Sockaddr