DesignMasterID Property

See Also    Example    Applies To

Sets or returns a 16-byte GUID that uniquely identifies the Design Master in a replica set (Microsoft Jet workspaces only).

Syntax

VOIDSetDesignMasterID(LPCTSTR pstrMasterID);

CStringGetDesignMasterID(VOID);

Parameters

Type Argument Description
LPCTSTR pstrMasterID A pointer to a string that contains the 16-byte GUID of a Design Master.

Remarks

You should set the DesignMasterID property only if you need to move the current Design Master. Setting this property makes a specific replica in the replica set the Design Master.

Caution Never create a second Design Master in a replica set. The existence of a second Design Master can result in the loss of data.

Under extreme circumstances — for example, if the Design Master is erased or corrupted — you can set this property at the current replica. However, setting this property at a replica when there is already another Design Master in the set might partition your replica set into two irreconcilable sets and prevent any further synchronization of data.

If you decide to make a replica of the new Design Master for the set, synchronize it with all the replicas in the replica set before setting the DesignMasterID property in the replica. The replica must be open in exclusive mode in order to make it the Design Master.

If you make a replica that is designated read-only into the Design Master, the target replica is made read/write; the old Design Master also remains read/write.

The DesignMasterID property setting is stored in the MSysRepInfo system table.