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 |
|