Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Multicast Socket Option Behavior

This page describes the behavior of multicast socket options based on various socket option settings states.

For example, this page describes the behavior when the IP_ADD_SOURCE_MEMBERSHIP socket option is set on a socket for which the IP_ADD_SOURCE_MEMBERSHIP option has already been set with the specified group/source pair on the same network interface. It is permitted to call IP_ADD_SOURCE_MEMBERSHIP on the same group on a different network interface.

This page assists in properly designing and troubleshooting Windows Sockets multicast applications.

Initial socket optionConflicting subsequent socket optionError returnedRemarks
IP_ADD_MEMBERSHIPIP_ADD_MEMBERSHIPWSAEADDRNOTAVAILDo not call IP_ADD_MEMBERSHIP with the same group more than once on the same network interface.
IP_ADD_SOURCE_MEMBERSHIPWSAEADDRNOTAVAILDo not call IP_ADD_SOURCE_MEMBERSHIP with the same group previously called with IP_ADD_MEMBERSHIP on the same network interface.
IP_DROP_SOURCE_MEMBERSHIPWSAEINVALUse IP_BLOCK_SOURCE instead.
IP_UNBLOCK_SOURCEWSAEINVALReturns an error when attempting to unblock a group/source pair that has not previously been blocked on the same network interface.
IP_DROP_MEMBERSHIPAny subsequent call on the same group or group/source pairWSAEINVALMaking socket option calls on a group or group/source pair not currently in the inclusion list (due to dropping membership, or otherwise) results in an error.
IP_ADD_SOURCE_MEMBERSHIPIP_ADD_MEMBERSHIPWSAEADDRNOTAVAILDo not call IP_ADD_MEMBERSHIP with the same group previously called with IP_ADD_SOURCE_MEMBERSHIP on the same network interface.
IP_ADD_SOURCE_MEMBERSHIPWSAEADDRNOTAVAILDo not call IP_ADD_SOURCE_MEMBERSHIP with the same group/source pair previously called with IP_ADD_SOURCE_MEMBERSHIP on the same network interface.
IP_UNBLOCK_SOURCEWSAEINVALReturns an error when attempting to unblock a group/source pair that has not previously been blocked on the same network interface.
IP_DROP_SOURCE_MEMBERSHIPIP_UNBLOCK_SOURCEWSAEINVALReturns an error when attempting to unblock a group/source pair that has not previously been blocked on the same network interface.
IP_DROP_SOURCE_MEMBERSHIPWSAEADDRNOTAVAILReturns an error when attempting to drop a group/source pair that is not in the inclusion list on the same network interface.
IP_BLOCK_SOURCEIP_BLOCK_SOURCEWSAEADDRNOTAVAILReturns an error when attempting to block a group/source pair that is already blocked on the same network interface.
IP_ADD_SOURCE_MEMBERSHIPWSAEINVALUse IP_UNBLOCK_SOURCE instead.
IP_ADD_MEMBERSHIPWSAEINVALUse IP_UNBLOCK_SOURCE instead.
IP_UNBLOCK_SOURCEIP_UNBLOCK_SOURCEWSAEADDRNOTAVAILReturns an error when attempting to unblock a group/source pair that is not in the blocked list on the same network interface.

 

 

 

Show:
© 2017 Microsoft