Interface ILocatorFinder

Namespace

IceRpc.Ice

Assembly

IceRpc.Locator.dll

Provides access to a LocatorProxy object via a fixed identity. A LocatorFinder is always registered with identity Ice/LocatorFinder. This allows clients to obtain the associated Locator proxy with just the endpoint information of the object. For example, you can use the LocatorFinder proxy Ice/LocatorFinder:tcp -h somehost -p 4061 to get the Locator proxy MyIceGrid/Locator:tcp -h somehost -p 4061.

public interface ILocatorFinder

Remarks

Use the methods of this interface to invoke operations on a remote Ice service that implements LocatorFinder. The Ice compiler generated this client-side interface from Ice interface ::Ice::LocatorFinder.

Methods

GetLocatorAsync(IFeatureCollection?, CancellationToken)

Gets a proxy to the associated LocatorProxy. The proxy might point to several replicas.

Task<LocatorProxy?> GetLocatorAsync(IFeatureCollection? features = null, CancellationToken cancellationToken = default)

Parameters

features IFeatureCollection

The features of this invocation.

cancellationToken CancellationToken

A cancellation token that receives the cancellation requests.

Returns

Task<LocatorProxy?>

The locator proxy. This proxy is never null.

Exceptions

DispatchException

Thrown when the dispatch of the operation failed. This exception is provided through the returned task; it's never thrown synchronously.