DfsrConnectionInfo class

This class provides statistical and operational information for each incoming and outgoing connection of the local replication group members.

Syntax

class DfsrConnectionInfo : CIM_LogicalElement
{
  string   ConnectionGuid;
  string   MemberGuid;
  string   MemberName;
  string   PartnerGuid;
  string   PartnerName;
  string   ReplicationGroupGuid;
  string   ReplicationGroupName;
  boolean  Inbound;
  uint32   State;
  datetime LastSyncTime;
  uint32   LastSyncDuration;
  datetime LastSuccessfulSyncTime;
  datetime NextSyncTime;
  uint32   LastErrorCode;
  uint32   LastErrorMessageId;
};

Members

The DfsrConnectionInfo class has these types of members:

• Methods
• Properties

Methods

The DfsrConnectionInfo class has these methods.

Properties

The DfsrConnectionInfo class has these properties.

ConnectionGuid

Data type: string

Access type: Read-only

Qualifiers: Key, MinLen (36) , MaxLen (36)

The unique connection identifier.

Inbound

Data type: boolean

Access type: Read-only

Indicates the direction of the connection between the local computer and this partner; it can be inbound (coming from the partner) or outbound (going to the partner).

LastErrorCode

Data type: uint32

Access type: Read-only

Qualifiers: Values (Success) , ValueMap (0)

The last error code.

Value	Meaning
DFSR_E_CANNOT_CONNECT	Could not connect to the partner. This value is returned only for inbound connections.

 

LastErrorMessageId

Data type: uint32

Access type: Read-only

Qualifiers: Values (Success) , ValueMap (0)

The event log message identifier that corresponds to the last error code.

For DFSR_E_CANNOT_CONNECT, the LastErrorMessageId is one of the following values.

Value	Meaning
EVENT_DFSR_CONNECTION_ERROR	The DFS Replication service encountered an error communicating with the partner. The service will retry the connection periodically.
EVENT_DFSR_CONNECTION_SERVICE_UNREACHABLE	The DFS Replication service failed to communicate with the partner. This error can occur if the host is unreachable or if the DFS Replication service is not running on the server. The service will retry the connection periodically.
EVENT_DFSR_CONNECTION_UNRECOGNIZED	The DFS Replication service failed to communicate with the partner. The partner did not recognize the connection or the replication group configuration. The service will retry the connection periodically.
EVENT_DFSR_INCOMPATIBLE_VERSION	The DFS Replication service failed to communicate with the partner. The partner is running a different version of the communication protocol. This error can be avoided by ensuring that the correct version of DFS Replication is installed on both servers, including any service packs and downloads.

 

LastSuccessfulSyncTime

Data type: datetime

Access type: Read-only

The time stamp of the last successful synchronization session since the service was started. The default value is 1/1/9999.

This property is valid only for inbound connections.

LastSyncDuration

Data type: uint32

Access type: Read-only

Qualifiers: Units ("Seconds")

The duration of the last successful synchronization session, in seconds. The default value is 0.

This property is valid only for inbound connections.

LastSyncTime

Data type: datetime

Access type: Read-only

The time stamp of the last attempted synchronization operation. The default is 1/1/9999.

This property is valid only for inbound connections.

MemberGuid

Data type: string

Access type: Read-only

Qualifiers: MinLen (36) , MaxLen (36)

The local replication group member identifier.

MemberName

Data type: string

Access type: Read-only

The member name. This is typically the unqualified DNS name of the local computer.

NextSyncTime

Data type: datetime

Access type: Read-only

The time stamp of next scheduled synchronization session. The default value is 1/1/9999.

This property is valid only for inbound connections.

PartnerGuid

Data type: string

Access type: Read-only

Qualifiers: MinLen (36) , MaxLen (36)

The unique identifier of the partner object.

PartnerName

Data type: string

Access type: Read-only

The partner name. This is typically the unqualified DNS name of the partner computer.

ReplicationGroupGuid

Data type: string

Access type: Read-only

Qualifiers: MinLen (36) , MaxLen (36)

The unique replication group identifier.

ReplicationGroupName

Data type: string

Access type: Read-only

The name of the replication group that owns this connection.

State

Data type: uint32

Access type: Read-only

Qualifiers: Values (Connecting, Online, Offline, In Error) , ValueMap (0, 1, 2, 3)

The current connection state.

Remarks

Outbound connections are created on demand after the partner establishes a connection. The DFSR service cannot detect when an outbound connection has been deleted; by default, it waits for 12 hours idle time before determining that the connection has been lost.

Inbound connections persist as long as they are configured.

The following state diagram illustrates the transitions between the connection states.

Requirements

Send comments about this topic to Microsoft

Build date: 10/26/2012