estrutura GROUP_REQ (ws2ipdef.h)
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) |