INotifyReplica::YouAreAReplica method (reconcil.h)

Notifies an object that it may be subject to subsequent reconciliation through the Reconcile method.

Syntax

HRESULT YouAreAReplica(
  ULONG    ulcOtherReplicas,
  IMoniker **rgpmkOtherReplicas
);

Parameters

ulcOtherReplicas

Type: ULONG

The number of other replicas of the object. This parameter must not be zero.

rgpmkOtherReplicas

Type: IMoniker**

The address of an array that contains the addresses of the monikers to use to access the other replicas.

Return value

Type: HRESULT

Returns S_OK if successful, or E_UNEXPECTED otherwise.

Remarks

An object may be notified that it is a replica more than once. Briefcase reconcilers are not required to implement this interface. Initiators are not required to call this interface if it is implemented. However, an object's implementation of Reconcile may fail if that object has not previously been notified through INotifyReplica::YouAreAReplica that it may be subject to reconciliation.

The briefcase calls the INotifyReplica interface when objects are added to it.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header reconcil.h
DLL Shell32.dll (version 4.0 or later)