setsourcefilter 函式 (ws2tcpip.h)
setsourcefilter 內嵌函式會設定 IPv4 或 IPv6 套接字的多播篩選狀態。
語法
int setsourcefilter(
[in] SOCKET Socket,
[in] ULONG Interface,
[in] const SOCKADDR *Group,
[in] int GroupLength,
[in] MULTICAST_MODE_TYPE FilterMode,
[in] ULONG SourceCount,
[in] const SOCKADDR_STORAGE *SourceList
);
參數
[in] Socket
識別多播套接字的描述項。
[in] Interface
多播介面的介面索引。
[in] Group
多播群組套接字位址的指標。
[in] GroupLength
Group 參數所指向之套接字地址的長度，以位元組為單位。
[in] FilterMode
多播群組位址的多播篩選模式。
[in] SourceCount
SourceList 參數所指向之緩衝區中的來源位址數目。
[in] SourceList
緩衝區的指標，其中包含要與多播篩選相關聯的IP位址。
傳回值
成功時， setsourcefilter 會傳回 NO_ERROR (0) 。 任何非零的傳回值都表示失敗，而且可以呼叫 WSAGetLastError 來擷取特定的錯誤碼。
| 錯誤碼 | 意義 |
|---|---|
| 緩衝區空間不足。 | |
| 描述項不是套接字。 |
備註
setsourcefilter 內嵌函式可用來設定 IPv4 或 IPv6 套接字的多播篩選狀態。
此函式是 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 |