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

Статья
08/28/2023

Структура GROUP_SOURCE_REQ предоставляет сведения о группе многоадресной рассылки для IPv6- или IPv4-адресов, включая исходный IP-адрес.

Синтаксис

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

Члены

gsr_interface

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

gsr_group

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

gsr_source

Исходный адрес, который следует использовать. Это может быть адрес многоадресной рассылки IPv6 или IPv4, но это должно быть то же семейство адресов (IPv6 или IPv4), что и адрес, указанный в элементе gsr_group .

Структура GROUP_SOURCE_REQ используется с адресами многоадресной рассылки IPv6 или IPv4. Структура GROUP_SOURCE_REQ используется с параметрами MCAST_BLOCK_SOURCE, MCAST_JOIN_SOURCE_GROUP, MCAST_LEAVE_SOURCE_GROUP и MCAST_UNBLOCK_SOURCE сокетов.

Структура GROUP_SOURCE_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 можно использовать для получения сведений об индексе интерфейса, необходимых для элемента gsr_interface .

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

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

Требования


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