2.2.1.4.4 FRS_UPDATE

A structure that contains file metadata related to a particular file being processed by Distributed File System Replication (DFS-R).

typedef struct _FRS_UPDATE {
  long present;
  long nameConflict;
  unsigned long attributes;
  FILETIME fence;
  FILETIME clock;
  FILETIME createTime;
  FRS_CONTENT_SET_ID contentSetId;
  unsigned char hash[CONFIG_FILEHASH_DATASIZE];
  unsigned char rdcSimilarity[CONFIG_RDC_SIMILARITY_DATASIZE];
  GUID uidDbGuid;
  DWORDLONG uidVersion;
  GUID gvsnDbGuid;
  DWORDLONG gvsnVersion;
  GUID parentDbGuid;
  DWORDLONG parentVersion;
  [string] WCHAR name[260+1];
  long flags;
} FRS_UPDATE;

present: Indicates whether the file exists or has been deleted. The value MUST be either 0 or 1.

Value	Meaning
0x00000000	File has been deleted.
0x00000001	File exists.

nameConflict: Set if this update was tombstone due to a name conflict. The value MUST be either 0 or 1. This field MUST be 0 if present is 1.

attributes: The file's attributes.

fence: The fence clock.

clock: Logical, last change clock.

createTime: File creation time.

contentSetId: The content set ID (replicated folder) that this file belongs to.

hash: The SHA-1 hash of the file.

rdcSimilarity: The similarity hash of the file. The value will be all zeros if the similarity data was not computed. See [MS-RDC], 3.1.5.4.

uidDbGuid: The GUID portion of the file's UID. Same as the databaseGUID of the replicated folder where this file originated.

uidVersion: The VSN portion of the file's UID. This is assigned when the file is created.

gvsnDbGuid: The GUID portion of the file's GVSN. Same as the database GUID of the replicated folder where this file was last updated.

gvsnVersion: The VSN portion of the file's GVSN. This is assigned when the file was last updated.

parentDbGuid: The GUID portion of the UID of the file's parent. Same as the database GUID of the replicated folder where this file's parent originated.

parentVersion: The VSN portion of the UID of the file's parent. This is assigned when the parent of the file was created.

name: The file name, in UTF-16 form, of the file.

flags: A flags bitmask. The value SHOULD be 0 or FRS_UPDATE_FLAG_CLOCK_DECREMENTED. The client MUST ignore any bits other than FRS_UPDATE_FLAG_CLOCK_DECREMENTED.

Value	Meaning
0x00000000	The update is normal.
FRS_UPDATE_FLAG_CLOCK_DECREMENTED 0x00000010	The update is the result of a dirty shutdown on the remote partner and the clock has been decremented by the remote partner. The client MAY assign a new GVSN when installing an update with this flag.