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) を返します。 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
Library Ws2_32.lib
[DLL] Ws2_32.dll

こちらもご覧ください

MULTICAST_MODE_TYPE

SOCKADDR_STORAGE

getipv4sourcefilter

getsourcefilter

setipv4sourcefilter