Partager via


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
DfsRProvs.mof
DLL
DfsRWmiV2.dll

See also

DfsrConnectionInfo