GROUP_SOURCE_REQ 구조체(ws2ipdef.h)

아티클
08/28/2023

GROUP_SOURCE_REQ 구조는 원본 IP 주소를 포함하는 IPv6 또는 IPv4 주소에 대한 멀티캐스트 그룹 정보를 제공합니다.

구문

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 멀티캐스트 주소일 수 있지만 gsr_group 멤버에 지정된 주소와 동일한 주소 패밀리(IPv6 또는 IPv4)여야 합니다.

설명

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 구조 및 관련 구조는 RFC 3768 섹션 5 및 8.2의 IETF 권장 사항을 기반으로 합니다. 자세한 내용은 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 구조체는 Ws2tcpip.h 헤더 파일에 자동으로 포함되는 Ws2ipdef.h 헤더 파일에 정의됩니다. Ws2ipdef.h 헤더 파일은 직접 사용하면 안 됩니다.

요구 사항


지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	ws2ipdef.h(Ws2tcpip.h 포함)