SyncSessionContext Constructor
Initializes a new instance of the SyncSessionContext class by using the specified ID format schema and callback object.
Assembly: Microsoft.Synchronization (in Microsoft.Synchronization.dll)
public:
SyncSessionContext(
SyncIdFormatGroup^ idFormats,
SyncCallbacks^ callbacks
)
Parameters
- idFormats
- Type: Microsoft.Synchronization::SyncIdFormatGroup
The ID format schema of the provider.
- callbacks
- Type: Microsoft.Synchronization::SyncCallbacks
An object that receives notification of events that occur during synchronization. Can be a nullptr.
| Exception | Condition |
|---|---|
| ArgumentNullException | idFormats is a nullptr. |
A SyncSessionContext object is typically created by Sync Framework and passed to the provider in the BeginSession method. This constructor is useful when a proxy provider is communicating with a remote provider across a computer boundary, because it allows the remote provider to create a SyncSessionContext object. Be aware that when callbacks is not a nullptr, notifications are sent from the remote provider to the application, which can degrade performance, so callbacks should only be used when necessary or when performance is not an issue. Also, in the callback methods, the position of the remote provider is reported as Unknown.