MM_AddMirrorObjectToMirrorGroup

Adds an unreserved mirror object identified by the object ID mirrorObjectID to the mirror group identified by the object handle mirrorGroupObjectID to create a single mirror object.

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_AddMirrorObjectToMirrorGroup ( 
     LONG   mirrorObjectID, 
     LONG   mirrorGroupObjectID );

Parameters

mirrorObjectID
The Media Manager object ID of the unreserved mirror object to be added to the mirror group.
mirrorGroupObjectID
The Media Manager object ID of the unreserved mirror group to which the mirror object will be added.

Return Values

The following table lists return values and descriptions.

0x00000000

MM_OK

0x00000001

MM_INVALID_OBJECT

0x00000005

MM_INVALID_MODE

0x00000006

MM_RESERVATION_CONFLICT

0x00000016

MM_PARAMETER_ERROR

0xFFFFFFFF

MM_FAILURE

Remarks

Between 1 and 8 mirror objects can be part of a mirror group. The old mirror object associated with the mirrorObjectID will be removed from the Media Manager’s database and will no longer be accessible. Any existing data associated with the mirror object mirrorObjectID will be overwritten after this function is used. For details, please refer to Partition Management Concepts.