2.2.1.2.46 MIB_IPMCAST_SCOPE

The MIB_IPMCAST_SCOPE structure contains a multicast scope name and the associated IPv4 multicast group address and mask that define the scope. This structure is used in MIB_OPAQUE_INFO (section 2.2.1.2.52) structure.

 typedef struct {
   DWORD dwGroupAddress;
   DWORD dwGroupMask;
   WCHAR snNameBuffer[256];
   DWORD dwStatus;
   BYTE reserved[492];
 } MIB_IPMCAST_SCOPE,
  *PMIB_IPMCAST_SCOPE;

dwGroupAddress: A 32-bit integer representation of the IPv4 group address which, when combined with the corresponding value in dwGroupMask, identifies the group range for which the multicast scope exists.

Note Scoped addresses MUST come from the range 239.0.0.0 to 239.255.255.255 as specified in [RFC2365].

dwGroupMask: A 32-bit integer representation of the IPv4 group address mask which, when combined with the corresponding value in dwGroupAddress, identifies the group range for which the multicast scope exists.

snNameBuffer: A Unicode string, suitable for display to multicast application users, that contains the text name associated with the multicast scope.

If no name is specified, the default name is the string representation of the scoped address in dwGroupAddress with the address and mask length appended and separated by a backslash "/" character, of the form "239.*.*.*.x/y", where x is the address length and y is the mask length.

dwStatus: A status value that describes the current status of this row in an MFE scope table.

Value

Meaning

0x00000001

Row has an active status.

0x00000002

Row has a notInService status.

0x00000003

Row has a notReady status.

0x00000004

Row has a createAndGo status.

0x00000005

Row has a createAndWait status.

0x00000006

Row has a destroy status.

reserved: An array of 492 bytes that SHOULD be set to 0 and ignored on receive.