estrutura GROUP_SOURCE_REQ (ws2ipdef.h)

A estrutura GROUP_SOURCE_REQ fornece informações de grupo multicast para endereços IPv6 ou IPv4 que incluem o endereço IP de origem.

Sintaxe

typedef struct group_source_req {
  ULONG            gsr_interface;
  SOCKADDR_STORAGE gsr_group;
  SOCKADDR_STORAGE gsr_source;
} GROUP_SOURCE_REQ, *PGROUP_SOURCE_REQ;

Membros

gsr_interface

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

gsr_group

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

gsr_source

O endereço de origem que deve ser usado. Pode ser um endereço multicast IPv6 ou IPv4, mas deve ser a mesma família de endereços (IPv6 ou IPv4) que o endereço especificado no membro gsr_group .

Comentários

A estrutura GROUP_SOURCE_REQ é usada com endereços multicast IPv6 ou IPv4. A estrutura de GROUP_SOURCE_REQ é usada com as opções de soquete MCAST_BLOCK_SOURCE, MCAST_JOIN_SOURCE_GROUP, MCAST_LEAVE_SOURCE_GROUP e MCAST_UNBLOCK_SOURCE.

A estrutura GROUP_SOURCE_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 gsr_interface .

A estrutura GROUP_SOURCE_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_SOURCE_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

Confira também

GROUP_FILTER

GROUP_REQ

Getadaptersaddresses

Programação multicast

SOCKADDR_STORAGE

Opções de soquete

ip_mreq

ipv6_mreq