MM_DelPartitionFromMirrorGroup

Removes a selected mirrored partition from the mirror group it is currently in and creates a new out-of-sync mirror object for the partition.

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_DelPartitionFromMirrorGroup ( 
     LONG   partitionObjectID );

Parameters

partitionObjectID
The Media Manager object ID of the unreserved partition object that is to be removed from its current mirror group.

Return Values

The following table lists return values and descriptions.

0x00000000

MM_OK

0x00000001

MM_INVALID_0BJECT

0x00000006

MM_RESERVATION_CONFLICT

0xFFFFFFFF

MM_FAILURE

Remarks

The partition objects that make up a mirror group can be determined by using the information returned by MM_ReturnObjectMappingInfo.

An application must not perform this function on a partition which is part of a mirror group that is not currently in sync, unless it is sure that the partition to be removed contains the out-of-sync data.

Also, as stated earlier, the mirror object that is created as a result of this function might not have the same object number as it did prior to inclusion in the mirror group.