estructura GROUP_SOURCE_REQ (ws2ipdef.h)

Artículo
08/28/2023

La estructura GROUP_SOURCE_REQ proporciona información del grupo de multidifusión para las direcciones IPv6 o IPv4 que incluye la dirección IP de origen.

Sintaxis

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

Miembros

gsr_interface

Índice de interfaz de la interfaz local en la que se debe unir, quitar, bloquear o desbloquear el grupo de multidifusión.

gsr_group

Dirección del grupo de multidifusión. Puede ser una dirección de multidifusión IPv6 o IPv4.

gsr_source

Dirección de origen que se debe usar. Puede ser una dirección de multidifusión IPv6 o IPv4, pero debe ser la misma familia de direcciones (IPv6 o IPv4) que la dirección especificada en el miembro gsr_group .

Observaciones

La estructura de GROUP_SOURCE_REQ se usa con direcciones de multidifusión IPv6 o IPv4. La estructura de GROUP_SOURCE_REQ se usa con las opciones de socket de MCAST_BLOCK_SOURCE, MCAST_JOIN_SOURCE_GROUP, MCAST_LEAVE_SOURCE_GROUP y MCAST_UNBLOCK_SOURCE.

La estructura de GROUP_SOURCE_REQ y las estructuras relacionadas usadas para la programación de multidifusión se basan en las recomendaciones de IETF en las secciones 5 y 8.2 de RFC 3768. Para obtener más información, vea http://www.ietf.org/rfc/rfc3678.txt.

En Windows Vista y versiones posteriores, hay disponible un conjunto de opciones de socket para la programación de multidifusión que admite direcciones IPv6 e IPv4. Estas opciones de socket son independientes de IP y se pueden usar en IPv6 e IPv4. Estas opciones independientes de IP usan las GROUP_REQ y las estructuras de GROUP_SOURCE_REQ y son las opciones de socket preferidas para la programación de multidifusión en Windows Vista y versiones posteriores.

La función GetAdaptersAddresses se puede usar para obtener información de índice de interfaz necesaria para el miembro gsr_interface .

La estructura de GROUP_SOURCE_REQ y las opciones de socket que usan esta estructura solo son válidas en datagramas y sockets sin formato (el tipo de socket debe ser SOCK_DGRAM o SOCK_RAW).

La estructura GROUP_SOURCE_REQ se define en el archivo de encabezado Ws2ipdef.h que se incluye automáticamente en el archivo de encabezado Ws2tcpip.h . Los archivos de encabezado Ws2ipdef.h nunca se deben usar directamente.

Requisitos


Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	ws2ipdef.h (incluya Ws2tcpip.h)