findObjectByTypeOnLeastLoadedNodeAsync() [1/2]

std::future< std::optional< Ice::ObjectPrx > > IceGrid::QueryPrx::findObjectByTypeOnLeastLoadedNodeAsync ( std::string_view type, LoadSample sample, const Ice::Context & context = Ice::noExplicitContext ) const

nodiscard

Finds a well-known object by type on the least-loaded node.

If the registry does not know which node hosts the object (for example, because the object was registered with a direct proxy), the registry assumes the object is hosted on a node that has a load average of 1.0.

Parameters

type	The object type.
sample	The sampling interval.
context	The request context.

Returns

A future that becomes available when the invocation completes. This future holds:

• A proxy to the well-known object, or null if no such object is registered.