ForceReplication method
Collapse the table of content
Expand the table of content

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

 

 

Show:
© 2016 Microsoft