Ice 3.9
C++ API Reference
Loading...
Searching...
No Matches

◆ findObjectByIdAsync() [2/2]

std::function< void()> Ice::LocatorPrx::findObjectByIdAsync ( const Identity & id,
std::function< void(std::optional< Ice::ObjectPrx >)> response,
std::function< void(std::exception_ptr)> exception = nullptr,
std::function< void(bool)> sent = nullptr,
const Ice::Context & context = Ice::noExplicitContext ) const

Finds an object by identity and returns a dummy proxy with endpoint(s) that can be used to reach this object.

This dummy proxy may be an indirect proxy that requires further resolution using Ice::LocatorPrx::findAdapterById.

Parameters
idThe identity.
responseThe response callback. The Ice runtime calls this function from an Ice thread pool thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this function. It accepts:
  • A dummy proxy, or null if an object with the requested identity was not found.
exceptionThe exception callback. The Ice runtime calls this function from an Ice thread pool thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this function.
sentThe sent callback. The Ice runtime calls this function when the request is accepted by the transport. When the request is accepted synchronously, the Ice runtime calls this function from the current thread and passes true as argument. When the request is accepted asynchronously, the Ice runtime calls this function from an Ice thread pool thread and passes false as argument. If you set Ice::InitializationData::executor, the executor determines the thread that executes this function in the asynchronous case.
contextThe request context.
Returns
A function that can be called to cancel the invocation locally.