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以外，0.x.x 區塊中第一個八) 位 (0.x.x.x 區塊中的任何IP位址都會被視為介面索引。 介面索引是 24 位的數位，而且不會使用 0.0.0.0/8 IPv4 位址區塊， (保留此範圍) 。

若要使用 1 的介面索引，與 0.0.0.1 的 IP 位址相同。

[in] Group

多播群組的 IPv4 位址。

[in] FilterMode

多播群組位址的多播篩選模式。

[in] SourceCount

SourceList 參數所指向之緩衝區中的來源位址數目。

[in] SourceList

緩衝區的指標，其中包含要與多播篩選相關聯的IP位址。

傳回值

成功時， setipv4sourcefilter 會傳回 NO_ERROR (0) 。 任何非零傳回值都表示失敗，而且呼叫 WSAGetLastError 即可擷取特定的錯誤碼。

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

備註

setipv4sourcefilter 內嵌函式可用來設定IPv4 套接字的多播篩選狀態。

此函式是 RFC 3678 中定義之多播來源篩選器的套接字介面延伸模組之一部分。 應用程式可以使用這些函式來擷取和設定與套接字相關聯的多播來源地址篩選器。

Windows Phone 8：Windows Phone 8 和更新版本上的 Windows Phone Store 應用程式支援此函式。

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

另請參閱

MULTICAST_MODE_TYPE

getipv4sourcefilter

getsourcefilter

in_addr

setsourcefilter