CustomPeerResolverService.Register Method

Definition

Namespace:

System.ServiceModel.PeerResolvers

Assembly:

System.ServiceModel.dll

Registers a peer with the custom peer resolver service.

Overloads

Register(RegisterInfo)	Adds a new entry to the registration lookup table of the peer resolver service.
Register(Guid, String, PeerNodeAddress)	Adds a new entry to the registration lookup table of the peer resolver service.

Remarks

To register a peer node in a specific mesh, a correctly-formed RegisterInfo object must be supplied to one of the overloads for this method. This object contains the specific details necessary to register the registration entry requesting registration, including a GUID that uniquely identifies the registration entry, the mesh ID, and an endpoint address.

Register(RegisterInfo)

Adds a new entry to the registration lookup table of the peer resolver service.

public:
 virtual System::ServiceModel::PeerResolvers::RegisterResponseInfo ^ Register(System::ServiceModel::PeerResolvers::RegisterInfo ^ registerInfo);

public virtual System.ServiceModel.PeerResolvers.RegisterResponseInfo Register (System.ServiceModel.PeerResolvers.RegisterInfo registerInfo);

abstract member Register : System.ServiceModel.PeerResolvers.RegisterInfo -> System.ServiceModel.PeerResolvers.RegisterResponseInfo
override this.Register : System.ServiceModel.PeerResolvers.RegisterInfo -> System.ServiceModel.PeerResolvers.RegisterResponseInfo

Public Overridable Function Register (registerInfo As RegisterInfo) As RegisterResponseInfo

Parameters

registerInfo

RegisterInfo

RegisterInfo that contains information about the registration entry to register with the peer resolver service.

Returns

RegisterResponseInfo

RegisterResponseInfo that contains a copy of the entry added to the peer resolver service's registration lookup table.

Implements

Register(RegisterInfo)

Exceptions

InvalidOperationException

A registration entry with the same GUID already exists in the lookup table, or the custom peer resolver service has not been started with a previous call to Open().

ArgumentException

The RegisterInfo object supplied to this method was either null or not correctly formed.

NullReferenceException

The AddressInfo property of the object supplied to the registerInfo parameter was null.

ArgumentNullException

The meshId value supplied to this method is set to null.

Remarks

This method adds a new entry to the registration lookup table of the peer resolver service. Note that registrations made after the service is closed have no effect -- these entries are not returned by resolve requests.

Register(Guid, String, PeerNodeAddress)

Adds a new entry to the registration lookup table of the peer resolver service.

public:
 virtual System::ServiceModel::PeerResolvers::RegisterResponseInfo ^ Register(Guid clientId, System::String ^ meshId, System::ServiceModel::PeerNodeAddress ^ address);

public virtual System.ServiceModel.PeerResolvers.RegisterResponseInfo Register (Guid clientId, string meshId, System.ServiceModel.PeerNodeAddress address);

abstract member Register : Guid * string * System.ServiceModel.PeerNodeAddress -> System.ServiceModel.PeerResolvers.RegisterResponseInfo
override this.Register : Guid * string * System.ServiceModel.PeerNodeAddress -> System.ServiceModel.PeerResolvers.RegisterResponseInfo

Public Overridable Function Register (clientId As Guid, meshId As String, address As PeerNodeAddress) As RegisterResponseInfo

Parameters

clientId

Guid

A Guid that specifies a unique identifier for the registration entry to register with the resolver service.

meshId

String

A String that specifies the mesh ID of the peer mesh in which the registration entry participates.

address

PeerNodeAddress

A PeerNodeAddress that contains the endpoint address of the registration entry.

Returns

RegisterResponseInfo

A RegisterResponseInfo that contains a copy of the entry added to the peer resolver service's registration lookup table.

Exceptions

InvalidOperationException

A registration entry with the same GUID already exists in the lookup table, or the custom peer resolver service has not been started with a previous call to Open().

ArgumentException

The RegisterInfo object supplied to this method was either null or not correctly formed.

ArgumentNullException

The MeshId and/or the RegistrationId property of object supplied to the refreshInfo parameter was null.

NullReferenceException

The MeshId property of the object supplied to the refreshInfo parameter is unknown.