Função setipv4sourcefilter (ws2tcpip.h)

  • Artigo

A função embutida setipv4sourcefilter define o estado do filtro multicast para um soquete IPv4.

Sintaxe

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
);

Parâmetros

[in] Socket

Um descritor que identifica um soquete multicast.

[in] Interface

O endereço IPv4 local da interface ou o índice de interface no qual o grupo multicast deve ser unido ou descartado.

Esse valor está na ordem de bytes de rede. Se esse membro especificar um endereço IPv4 de 0.0.0.0, a interface multicast IPv4 padrão será usada.

Qualquer endereço IP no bloco 0.x.x.x (primeiro octeto de 0), exceto o endereço IPv4 0.0.0.0, é tratado como um índice de interface. Um índice de interface é um número de 24 bits e o bloco de endereçoS IPv4 0.0.0.0/8 não é usado (esse intervalo é reservado).

Usar um índice de interface de 1 seria o mesmo que um endereço IP de 0.0.0.1.

[in] Group

O endereço IPv4 do grupo multicast.

[in] FilterMode

O modo de filtro multicast para endereço de grupo multicast.

[in] SourceCount

O número de endereços de origem no buffer apontado pelo parâmetro SourceList .

[in] SourceList

Um ponteiro para um buffer com os endereços IP a serem associados ao filtro multicast.

Retornar valor

Em caso de êxito, setipv4sourcefilter retorna NO_ERROR (0). Qualquer valor retornado diferente de zero indica falha e um código de erro específico pode ser recuperado chamando WSAGetLastError.

Código do erro Significado
WSAENOBUFS
 Espaço em buffer insuficiente está disponível.
WSAENOTSOCK
 O descritor não é um soquete.

Comentários

A função embutida setipv4sourcefilter é usada para definir o estado do filtro multicast para um soquete IPv4.

Essa função faz parte das extensões de interface de soquete para filtros de origem multicast definidos no RFC 3678. Um aplicativo pode usar essas funções para recuperar e definir os filtros de endereço de origem multicast associados a um soquete.

Windows Phone 8: essa função tem suporte para aplicativos da Windows Phone Store no Windows Phone 8 e posterior.

Windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posteriores.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8.1, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho ws2tcpip.h
Biblioteca Ws2_32.lib
DLL Ws2_32.dll

Confira também

MULTICAST_MODE_TYPE

getipv4sourcefilter

getsourcefilter

End_inet

setsourcefilter