Provides a resolution decision for a sync conflict.
Note On Windows Server operating systems beginning with Windows Server 2008 R2, the Offline Files COM API and WMI provider are available only if the Desktop Experience feature is installed.
HRESULT ResolveConflict( [in] LPCWSTR pszPath, [in] DWORD fStateKnown, [in] OFFLINEFILES_SYNC_STATE state, [in] DWORD fChangeDetails, [out] OFFLINEFILES_SYNC_CONFLICT_RESOLVE *pConflictResolution, [out] LPWSTR *ppszNewName );
- pszPath [in]
The fully qualified UNC path of the item in conflict.
- fStateKnown [in]
Indicates if the sync state was based on the client state, server state, or both. This parameter can be one or both of the following flag values.
The sync state was based on the client state.
The sync state was based on the server state.
- state [in]
A value from the OFFLINEFILES_SYNC_STATE enumeration indicating the state of the item in conflict.
- fChangeDetails [in]
In cases where the state code indicates a change in item state, this value describes the change in further detail. The value can be either OFFLINEFILES_CHANGES_NONE (0x00000000) or one or more of the following flag values:
- pConflictResolution [out]
Receives the desired resolution code. Specify a value from the OFFLINEFILES_SYNC_CONFLICT_RESOLVE enumeration.
- ppszNewName [out]
If the value of the pConflictResolution parameter is OFFLINEFILES_SYNC_CONFLICT_RESOLVE_KEEPALLCHANGES, the conflict handler must provide a new name for the item. This new name is used for the new copies created remotely and locally. Note that this is a file name, not a fully qualified path.
The name string must be allocated using CoTaskMemAlloc.
This parameter may be NULL if a new name is not required by the resolution.
The Offline Files conflict handler used by Sync Center creates a name of the following format:
<original name> (<user name> vN).<original ext>
where N is a version number. Therefore, if the original file name is samples.doc and the user's name is Alice, the new file name will be:
samples (Alice v1).doc
If a file of that name exists the Offline Files conflict handler increments N until a unique name is found, for example:
- samples (Alice v2).doc
- samples (Alice v3).doc
This description is provided only to illustrate how the Offline Files conflict handler in Sync Center creates new file names. An implementation of IOfflineFilesSyncConflictHandler is free to use any name format that it wishes to define.
The return value is ignored.
Minimum supported client
|Windows Vista [desktop apps only]|
Minimum supported server
|Windows Server 2008 [desktop apps only]|
Build date: 10/15/2013