MM_ForceMirrorGroupInSync

Changes the status of a mirror group to synchronized.

Local Servers:Blocking
Remote Servers:Blocking
NetWare Server: 5.x
Platform:DOS, NLM, OS/2, Windows* 3.1, Windows NT*, Windows*95
Service:Media Manager

Syntax

  LONG MM_ForceMirrorGroupInSync ( 
     LONG   mirrorGroupObjectID );
  

Parameters

mirrorGroupObjectID
The Media Manager object ID of the mirror group to be declared synchronized.

Return Values

The following table lists return values and descriptions.

0x00000000

MM_OK

0x00000001

MM_INVALID_OBJECT

0xFFFFFFFF

MM_FAILURE

Remarks

Currently, this function affects only the first two mirrored partitions in a mirror group, even though the group can have up to eight partitions in it.

This function DOES NOT synchronize a mirrored partition. This function is used when a mirror group is created and is known to be empty to prevent the synchronizing process from mirroring any random data on a new volume. If an existing mirrored partition needs to be synchronized, use the MM_RemirrorGroup function.

See Also

For a discussion of the safe use of this function, see Partition Management Concepts, Section 11.5, Group Mirror Objects.