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.
-
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,080 minutes).
Bandwidth [in]
The valid bandwidth level. This parameter can be one of the following values.
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
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| End of client support |
Windows Vista |
| Namespace |
Root\MicrosoftDfs |
| MOF |
|
| DLL |
|