ForceReplication method of the DfsrConnectionInfo class

Controls replication by either forcing or suspending replication. DFSR will revert to the normal schedule at the end of the specified duration.

Syntax

uint32 ForceReplication(
  [in]  uint32 Mode,
  [in]  uint32 DurationInMin,
  [in]  uint32 Bandwidth
);

Parameters

Mode [in]

The replication mode. This parameter can be one of the following values.

Value	Meaning
Obey Configured Schedule 1	Use the configured schedule.
Sync Now 2	Ignore the configured schedule and replicate now for the specified duration.
Stop Sync 3	Ignore the configured schedule and stop replication for the specified duration.
Sync Until In-Sync 4	Ignore the configured schedule until this member is fully synchronized with its upstream partner.

 

DurationInMin [in]

The duration, in minutes. This value cannot exceed one week (10,800 minutes).

Bandwidth [in]

The valid bandwidth level. This parameter can be one of the following values.

Value	Meaning
BANDWIDTH_LEVEL_OFF 0x0	No replication.
BANDWIDTH_LEVEL_16_KBPS 0x1	16 kilobits per second (Kbps).
BANDWIDTH_LEVEL_64_KBPS 0x2	64 Kbps.
BANDWIDTH_LEVEL_128_KBPS 0x3	128 Kbps.
BANDWIDTH_LEVEL_256_KBPS 0x4	256 Kbps.
BANDWIDTH_LEVEL_512_KBPS 0x5	512 Kbps.
BANDWIDTH_LEVEL_1_MBPS 0x6	1 Mbps.
BANDWIDTH_LEVEL_2_MBPS 0x7	2 Mbps.
BANDWIDTH_LEVEL_4_MBPS 0x8	4 Mbps.
BANDWIDTH_LEVEL_8_MBPS 0x9	8 Mbps.
BANDWIDTH_LEVEL_16_MBPS 0xA	16 Mbps.
BANDWIDTH_LEVEL_32_MBPS 0xB	32 Mbps.
BANDWIDTH_LEVEL_64_MBPS 0xC	64 Mbps.
BANDWIDTH_LEVEL_128_MBPS 0xD	128 Mbps.
BANDWIDTH_LEVEL_256_MBPS 0xE	256 Mbps.
BANDWIDTH_LEVEL_INFINITE 0xF	Full bandwidth (no throttling.)

 

Return value

This method returns one of the MONITOR_STATUS return codes or one of the system error codes.

Remarks

This method is meaningful only for inbound connections. It always fails with an error on outbound connections.

Requirements

See also

DfsrConnectionInfo

Send comments about this topic to Microsoft

Build date: 10/26/2012