MigrationNetworkOrder

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

This property is not supported.

**Windows Server 2008 R2: **

Specifies the order in which the cluster networks are used to create the data connection during a live migration. The networks are specified by the network ID returned by the GetClusterNetworkId function, separated by semicolons. The following table summarizes the attributes of the MigrationNetworkOrder property.

Attribute Value
Data type Null-terminated Unicode string
Access Read/write
Structure CLUSPROP_SZ
Maximum None (but see Maximum Property Size.)
Default NULL

Remarks

The system will attempt to create the network connection starting with the first network specified by the property, and stop when it could successfully set up the data connection. If the MigrationNetworkOrder property is empty, the networks are sorted based on the Metric and AutoMetric properties of the available networks.

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 MigrationNetworkOrder can be set with the following example code.

WCHAR szMigrationNetworkOrderData[] = L"766ea40b-eb0f-49d5-8d15-a6a9d0ecf920;2a8f9545-88e0-4526-bc96-890fbaeaa359";
CLUSPROP_SZ_DECLARE( MigrationNetworkOrderValue, 
                     sizeof( szMigrationNetworkOrderData ) / sizeof( WCHAR ) );

MigrationNetworkOrderValue.Syntax.dw = CLUSPROP_SYNTAX_LIST_VALUE_SZ;
MigrationNetworkOrderValue.cbLength  = sizeof( szMigrationNetworkOrderData );
StringCbCopy( MigrationNetworkOrderValue.sz, 
              MigrationNetworkOrderValue.cbLength, 
              szMigrationNetworkOrderData );

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2008 R2 Enterprise, Windows Server 2008 R2 Datacenter
End of client support
None supported
End of server support
Windows Server 2008 R2 Enterprise, Windows Server 2008 R2 Datacenter

See also

Virtual Machine Common Properties

GetClusterNetworkId

AutoMetric

Metric

CLUSPROP_SZ

CLUSPROP_SZ_DECLARE