DfsrIdRecordInfo class

This class provides access to ID Table records. The ID Table has a record for each file and folder known to DFSR. In addition, it keeps records of the deleted content.

Syntax

class DfsrIdRecordInfo : CIM_LogicalElement
{
  string   Uid;
  uint8    Flags;
  uint32   Attributes;
  string   GVsn;
  string   Usn;
  string   ParentUid;
  uint64   Fid;
  string   Volume;
  string   Fence;
  datetime Clock;
  datetime CreateTime;
  datetime UpdateTime;
  string   FileHash;
  string   FileName;
  string   FullPathName;
  uint32   Index;
  string   ReplicatedFolderGuid;
};

Members

The DfsrIdRecordInfo class has these types of members:

• Methods
• Properties

Methods

The DfsrIdRecordInfo class has these methods.

Properties

The DfsrIdRecordInfo class has these properties.

Attributes

Data type: uint32

Access type: Read-only

The file or folder attributes. For a list of values, see the GetFileAttributes function.

Clock

Data type: datetime

Access type: Read-only

The logical clock value assigned to the file or folder.

CreateTime

Data type: datetime

Access type: Read-only

The creation time stamp of the file or folder. This is the time at which the resource first appears in the replication group.

Fence

Data type: string

Access type: Read-only

The fence value associated with the file. This property can be one of the following values.

Value	Meaning
Unfence 0	This file or folder will lose all conflicts.
Initial Sync 1	Initial fence value for non-primary member.
Initial Primary 2	Initial fence value for primary member.
Default 3	Default fencing value.
Fence 4	Fence with current time stamp.

 

Fid

Data type: uint64

Access type: Read-only

The file reference number. On NTFS, each file is assigned an identifier which is unique on the volume; it can be used to open a handle to the file.

FileHash

Data type: string

Access type: Read-only

A hash value for the file content.

FileName

Data type: string

Access type: Read-only

The name of the file or folder.

Flags

Data type: uint8

Access type: Read-only

A combination of flags for present, authoritative, and file type flags.

Value	Meaning
PRESENT_FLAG 0x1	The resource is not a tombstone; it is available on the computer.
NAME_CONFLICT_FLAG 0x2	The tombstone was generated because of a name conflict. This flag is meaningful only for tombstones.
UID_VISIBLE_FLAG 0x4	The ID record has already been sent out to other partners; therefore, other partners are aware of this resource.
JOURNAL_WRAP_FLAG 0x10	The volume has had a journal wrap and the resource has not been checked to determine if there is any change by the journal wrap recovery process.
PENDING_TOMBSTONE_FLAG 0x20	The ID record is in the process of being tombstoned (or deleted.)

 

FullPathName

Data type: string

Access type: Read-only

The complete path to the file or folder.

Windows Server 2003 R2, Windows Vista, and Windows Server 2008:  This property is not supported until Windows Server 2008 R2.

GVsn

Data type: string

Access type: Read-only

The global version of the resource (file or folder). The format of this string is {DatabaseGUID}-VersionNumber, where DatabaseGUID is the GUID of the DFSR database and VersionNumber is an integer value assigned to each resource that increases when the resource is modified. Because the database GUID uniquely identifies the last computer that the resource was modified on, the GVsn property uniquely identifies a particular version of the resource.

Index

Data type: uint32

Access type: Read-only

The run-time index of the record. This value is used to partition the result of a large query.

ParentUid

Data type: string

Access type: Read-only

The unique identifier of the parent folder.

ReplicatedFolderGuid

Data type: string

Access type: Read-only

Qualifiers: MinLen (36) , MaxLen (36)

The unique identifier of the replicated folder.

Uid

Data type: string

Access type: Read-only

Qualifiers: Key

The unique identifier of the resource (file or folder). The format of this string is {DatabaseGUID}-VersionNumber, where DatabaseGUID is the GUID of the DFSR database and VersionNumber is an integer value assigned to each resource when it is created. Because the database GUID uniquely identifies the computer that the resource was created on, the Uid property uniquely identifies the resource.

UpdateTime

Data type: datetime

Access type: Read-only

The last time DFSR updated the record in response to a change in the resource.

Usn

Data type: string

Access type: Read-only

The USN (Update Sequence Number) at the time the resource is updated.

Volume

Data type: string

Access type: Read-only

The volume where the file or folder is located. The volume format is either \\.\C: or \\?\volume{GUID}.

Requirements

Send comments about this topic to Microsoft

Build date: 10/26/2012