структура GROUP_REQ (ws2ipdef.h)

Структура GROUP_REQ предоставляет сведения о группе многоадресной рассылки для адресов IPv6 или IPv4.

Синтаксис

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

Члены

gr_interface

Индекс интерфейса локального интерфейса, к которому должна быть присоединена или удалена группа многоадресной рассылки.

gr_group

Адрес группы многоадресной рассылки. Это может быть адрес многоадресной рассылки IPv6 или IPv4.

Комментарии

Структура GROUP_REQ используется с адресами многоадресной рассылки IPv6 или IPv4. Структура GROUP_REQ используется с параметрами сокета MCAST_JOIN_GROUP и MCAST_LEAVE_GROUP.

Структура GROUP_REQ и связанные структуры, используемые для многоадресного программирования, основаны на рекомендациях IETF, приведенных в разделах 5 и 8.2 RFC 3768. Для получения дополнительной информации см. http://www.ietf.org/rfc/rfc3678.txt.

В Windows Vista и более поздних версиях доступен набор параметров сокета для многоадресного программирования, поддерживающего адреса IPv6 и IPv4. Эти параметры сокета не зависят от IP-адресов и могут использоваться как для IPv6, так и для IPv4. Эти не зависящие от IP-адреса параметры используют структуры GROUP_REQ и GROUP_SOURCE_REQ и являются предпочтительными вариантами сокетов для многоадресного программирования в Windows Vista и более поздних версий.

Функцию GetAdaptersAddresses можно использовать для получения сведений об индексе интерфейса, необходимых для элемента gr_interface .

Структура GROUP_REQ и параметры сокетов, которые используют эту структуру, допустимы только для datagram и необработанных сокетов (тип сокета должен быть SOCK_DGRAM или SOCK_RAW).

Структура GROUP_REQ определяется в файле заголовка Ws2ipdef.h , который автоматически включается в файл заголовка Ws2tcpip.h . Файлы заголовков Ws2ipdef.h никогда не следует использовать напрямую.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть ws2ipdef.h (включая Ws2tcpip.h)

См. также раздел

GROUP_FILTER

GROUP_SOURCE_REQ

GetAdaptersAddresses

Многоадресное программирование

SOCKADDR_STORAGE

Параметры сокета

ip_mreq

ipv6_mreq