INotifyReplica::YouAreAReplica method (reconcil.h)

Article
02/22/2024

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)

Share via