setipv4sourcefilter 함수(ws2tcpip.h)
setipv4sourcefilter 인라인 함수는 IPv4 소켓에 대한 멀티캐스트 필터 상태를 설정합니다.
구문
int setipv4sourcefilter(
[in] SOCKET Socket,
[in] IN_ADDR Interface,
[in] IN_ADDR Group,
[in] MULTICAST_MODE_TYPE FilterMode,
[in] ULONG SourceCount,
[in] const IN_ADDR *SourceList
);
매개 변수
[in] Socket
멀티캐스트 소켓을 식별하는 설명자입니다.
[in] Interface
멀티캐스트 그룹을 조인하거나 삭제해야 하는 인터페이스 또는 인터페이스 인덱스의 로컬 IPv4 주소입니다.
이 값은 네트워크 바이트 순서입니다. 이 멤버가 0.0.0.0의 IPv4 주소를 지정하는 경우 기본 IPv4 멀티캐스트 인터페이스가 사용됩니다.
IPv4 주소 0.0.0.0을 제외한 0.x.x.x 블록의 모든 IP 주소(0의 첫 번째 8진수)는 인터페이스 인덱스로 처리됩니다. 인터페이스 인덱스는 24비트 숫자이며 0.0.0.0/8 IPv4 주소 블록은 사용되지 않습니다(이 범위는 예약되어 있습니다).
인터페이스 인덱스 1을 사용하는 것은 IP 주소 0.0.0.1과 동일합니다.
[in] Group
멀티캐스트 그룹의 IPv4 주소입니다.
[in] FilterMode
멀티캐스트 그룹 주소에 대한 멀티캐스트 필터 모드입니다.
[in] SourceCount
SourceList 매개 변수가 가리키는 버퍼의 원본 주소 수입니다.
[in] SourceList
멀티캐스트 필터와 연결할 IP 주소가 있는 버퍼에 대한 포인터입니다.
반환 값
성공하면 setipv4sourcefilter 는 NO_ERROR(0)을 반환합니다. 0이 아닌 반환 값은 실패를 나타내며 WSAGetLastError를 호출하여 특정 오류 코드를 검색할 수 있습니다.
| 오류 코드 | 의미 |
|---|---|
| 버퍼 공간이 부족합니다. | |
| 설명자가 소켓이 아닙니다. |
설명
setipv4sourcefilter 인라인 함수는 IPv4 소켓에 대한 멀티캐스트 필터 상태를 설정하는 데 사용됩니다.
이 함수는 RFC 3678에 정의된 멀티캐스트 원본 필터에 대한 소켓 인터페이스 확장의 일부입니다. 앱은 이러한 함수를 사용하여 소켓과 연결된 멀티캐스트 원본 주소 필터를 검색하고 설정할 수 있습니다.
Windows Phone 8: 이 함수는 Windows Phone 8 이상에서 Windows Phone 스토어 앱에서 지원됩니다.
Windows 8.1 및 Windows Server 2012 R2: 이 함수는 Windows 8.1, Windows Server 2012 R2 이상에서 Windows 스토어 앱에서 지원됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8.1, Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | ws2tcpip.h |
| 라이브러리 | Ws2_32.lib |
| DLL | Ws2_32.dll |