setsourcefilter 函式 (ws2tcpip.h)

發行項
03/13/2024

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 來擷取特定的錯誤碼。

錯誤碼	意義
WSAENOBUFS	緩衝區空間不足。
WSAENOTSOCK	描述項不是套接字。

備註

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