MulticastAddress

[The MulticastAddress property is no longer available for use as of Windows Server 2012.]

This property is not supported.

Windows Server 2003:  

Provides the Class D IPv4 multicast address used for heartbeat multicasting on the network. The following table summarizes the attributes of the MulticastAddress property.

AttributeValue
Data typeNull-terminated Unicode string
Access Read/write
StatusRequired
Structure CLUSPROP_SZ
MaximumNone (but see Maximum Property Size.)
DefaultVaries

 

Remarks

Class D IPv4 addresses are in the range 224.0.0.0 to 239.255.255.255.

If the string is not a Class D IPv4 address, the current multicast configuration is deleted and the cluster attempts to obtain a new address. This means that the contents of the MulticastAddress, MulticastConfigType, MulticastLeaseExpires, MulticastLeaseObtained, MulticastLeaseRequestId, and MulticastLeaseServer properties are erased. The cluster service does not report an error when this occurs.

The CLUSPROP_SZ_DECLARE macro creates a CLUSPROP_SZ structure with an array of the correct size.

Examples

The property value portion of a property list entry for MulticastAddress can be set with the following example code:


WCHAR                szMulticastAddressData[] = L"239.255.0.0";
CLUSPROP_SZ_DECLARE( MulticastAddressValue, 
                     sizeof(szMulticastAddressData) / sizeof(WCHAR) );

MulticastAddressValue.Syntax.dw = CLUSPROP_SYNTAX_LIST_VALUE_SZ;
MulticastAddressValue.cbLength  = sizeof( szMulticastAddressData );
StringCbCopy( MulticastAddressValue.sz, 
              MulticastAddressValue.cbLength, 
              szMulticastAddressData );


Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2003 Datacenter, Windows Server 2003 Enterprise

End of server support

Windows Server 2003 Datacenter, Windows Server 2003 Enterprise

See also

MulticastAddressRangeLower
MulticastAddressRangeUpper
MulticastConfigType
MulticastDisabled

 

 

Show: