We need a second generated client call for each DSTC_CLIENT-registered function that allows us to track its queuing and remote execution.
If the standard call is
int dstc_print_name_and_age(char name[32], int age);
then the tracking call would be
int dstc_track_print_name_and_age(dstc_context_t* context, delivery_callback_t delivery_cb, int* recipient_count, user_data_t user_data, char name[32], int age);
The return value is picked from errno.h and tells the caller if the call was successfully queued at the client side for transmission to the servers.
The arguments are as follow:
dstc_context_t* context
Caller-provided context to be used instead of the default one setup in the background by DSTC. Allows for detailed event and traffic management.
delivery_callback_t delivery_cb
Callback to invoke for every successful or failed delivery of the call to one of the registered servers. Please note that execution can still fail due to server-side errors.
int* recipient_count
Will be set to the number of servers that the call will be delivered to. The delivery_cb callback will be invoked once for each server.
user_data_t user_data
Caller-supplied user data enum that can be a pointer, uint32, uint64, etc. Will be provided with each call to the callback defined in delivery_callback, allowing the delivery callback to be tied to the original dstc_track_print_name_and_age() call.
We need a second generated client call for each DSTC_CLIENT-registered function that allows us to track its queuing and remote execution.
If the standard call is
int dstc_print_name_and_age(char name[32], int age);then the tracking call would be
int dstc_track_print_name_and_age(dstc_context_t* context, delivery_callback_t delivery_cb, int* recipient_count, user_data_t user_data, char name[32], int age);The return value is picked from
errno.hand tells the caller if the call was successfully queued at the client side for transmission to the servers.The arguments are as follow:
dstc_context_t* contextCaller-provided context to be used instead of the default one setup in the background by DSTC. Allows for detailed event and traffic management.
delivery_callback_t delivery_cbCallback to invoke for every successful or failed delivery of the call to one of the registered servers. Please note that execution can still fail due to server-side errors.
int* recipient_countWill be set to the number of servers that the call will be delivered to. The
delivery_cbcallback will be invoked once for each server.user_data_t user_dataCaller-supplied user data enum that can be a pointer, uint32, uint64, etc. Will be provided with each call to the callback defined in delivery_callback, allowing the delivery callback to be tied to the original
dstc_track_print_name_and_age()call.