estrutura SOCKADDR_IN6_LH (ws2ipdef.h)

Artigo
08/28/2023

A estrutura SOCKADDR_IN6 especifica um endereço de transporte e uma porta para a família de endereços AF_INET6 .

Sintaxe

typedef struct sockaddr_in6 {
  ADDRESS_FAMILY sin6_family;
  USHORT         sin6_port;
  ULONG          sin6_flowinfo;
  IN6_ADDR       sin6_addr;
  union {
    ULONG    sin6_scope_id;
    SCOPE_ID sin6_scope_struct;
  };
} SOCKADDR_IN6_LH, *PSOCKADDR_IN6_LH, *LPSOCKADDR_IN6_LH;

Membros

sin6_family

A família de endereços do endereço de transporte. Esse membro sempre deve ser definido como AF_INET6.

sin6_port

Um número da porta do protocolo de transporte.

sin6_flowinfo

As informações de fluxo IPv6.

sin6_addr

Uma estrutura IN6_ADDR que contém um endereço de transporte IPv6.

sin6_scope_id

Uma representação ULONG do identificador de escopo IPv6 definido no membro sin6_scope_struct .

sin6_scope_struct

Uma estrutura SCOPE_ID que contém o identificador de escopo para o endereço de transporte IPv6. A estrutura SCOPE_ID é definida da seguinte maneira:

typedef struct {
  union {
    struct {
      ULONG  Zone : 28;
      ULONG  Level : 4;
    };
    ULONG  Value;
  };
} SCOPE_ID, *PSCOPE_ID;

Zona

O índice de zona que identifica a zona à qual o endereço de transporte pertence. As zonas dos diferentes escopos são instanciadas da seguinte maneira:

Cada interface em um nó é composta por uma única zona de escopo local da interface.

Cada link e as interfaces anexadas a esse link compõem uma única zona de escopo de link local.

Há uma única zona de escopo global que compreende todos os links e interfaces na Internet.

Os limites de zonas de escopo diferentes de interface local, link-local e global são definidos pelos administradores de rede.

Um valor zero especifica a zona padrão.

Nível

O escopo do endereço de transporte IPv6. Esse escopo deve ser o mesmo que o valor de escopo IPv6 inserido no endereço de transporte IPv6. Esse membro pode ser um dos seguintes:

ScopeLevelInterface

O endereço de transporte tem escopo local da interface.

ScopeLevelLink

O endereço de transporte tem escopo link-local.

ScopeLevelSubnet

O endereço de transporte tem escopo local de sub-rede.

ScopeLevelAdmin

O endereço de transporte tem escopo admin-local.

ScopeLevelSite

O endereço de transporte tem escopo local do site.

ScopeLevelOrganization

O endereço de transporte tem escopo organizacional local.

ScopeLevelGlobal

O endereço de transporte tem escopo global.

Valor

Uma representação ULONG do identificador de escopo IPv6.

Comentários

Todos os dados na estrutura SOCKADDR_IN6, exceto a família de endereços, devem ser especificados em ordem de byte de rede (big-endian).

O tamanho da estrutura SOCKADDR_IN6 é muito grande para caber no espaço de memória fornecido por uma estrutura SOCKADDR . Para obter uma estrutura que tem a garantia de ser grande o suficiente para conter um endereço de transporte para todas as famílias de endereços possíveis, consulte SOCKADDR_STORAGE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	ws2ipdef.h (include Ws2ipdef.h)