estrutura GROUP_REQ (ws2ipdef.h)

Artigo
03/13/2024

A estrutura GROUP_REQ fornece informações de grupo multicast para endereços IPv6 ou IPv4.

Sintaxe

typedef struct group_req {
  ULONG            gr_interface;
  SOCKADDR_STORAGE gr_group;
} GROUP_REQ, *PGROUP_REQ;

Membros

gr_interface

O índice de interface da interface local na qual o grupo multicast deve ser unido ou descartado.

gr_group

O endereço do grupo multicast. Pode ser um endereço multicast IPv6 ou IPv4.

Comentários

A estrutura GROUP_REQ é usada com endereços multicast IPv6 ou IPv4. A estrutura de GROUP_REQ é usada com as opções de soquete MCAST_JOIN_GROUP e MCAST_LEAVE_GROUP.

A estrutura GROUP_REQ e as estruturas relacionadas usadas para programação multicast são baseadas em recomendações de IETF nas seções 5 e 8.2 do RFC 3768. Para obter mais informações, consulte http://www.ietf.org/rfc/rfc3678.txt.

No Windows Vista e posteriores, um conjunto de opções de soquete está disponível para programação multicast que dá suporte a endereços IPv6 e IPv4. Essas opções de soquete são independentes de IP e podem ser usadas no IPv6 e no IPv4. Essas opções independentes de IP usam o GROUP_REQ e as estruturas de GROUP_SOURCE_REQ e são as opções de soquete preferenciais para programação multicast no Windows Vista e posterior.

A função GetAdaptersAddresses pode ser usada para obter informações de índice de interface necessárias para o membro gr_interface .

A estrutura GROUP_REQ e as opções de soquete que usam essa estrutura são válidas apenas em datagrama e soquetes brutos (o tipo de soquete deve ser SOCK_DGRAM ou SOCK_RAW).

A estrutura GROUP_REQ é definida no arquivo de cabeçalho Ws2ipdef.h , que é incluído automaticamente no arquivo de cabeçalho Ws2tcpip.h . Os arquivos de cabeçalho Ws2ipdef.h nunca devem ser usados diretamente.

Requisitos

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