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

◆ setPropertiesAsync() [2/2]

std::function< void()> Ice::PropertiesAdminPrx::setPropertiesAsync ( const PropertyDict & newProperties,
std::function< void()> response,
std::function< void(std::exception_ptr)> exception = nullptr,
std::function< void(bool)> sent = nullptr,
const Ice::Context & context = Ice::noExplicitContext ) const

Updates the communicator's properties with the given property set.

If an entry in newProperties matches the name of an existing property, that property's value is replaced with the new value. If the new value is the empty string, the property is removed. Existing properties that are not modified or removed by the entries in newProperties are not affected by this update.

Parameters
newPropertiesProperties to add, change, or remove.
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.
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.
Remarks
When this proxy is a oneway or datagram proxy, the Ice runtime does not call the response callback: a successful invocation completes with the sent callback. When this proxy is a batch proxy, this function only adds the request to the batch: the Ice runtime calls none of the callbacks, and the request is sent later, by a flush.