OpenDOF Project
void(* DOFObjectProvider::Register)(DOFObjectProvider self, DOFOperation operation, DOFRequest request, DOFInterfaceEvent evt)

Callback for a Provider when a DOFInterfaceEvent handler is registered.

This callback must decide whether or not to accept the new registration. The Provider may choose to not allow the registration by throwing an exception on the request (see DOFRequest_Throw). The request will remain valid until the RegisterComplete callback is called. If the application chooses not to supply a RegisterComplete callback, then the registration request must be accepted or rejected synchronously inside this callback. If the application initially accepts the registration, the application can terminate it (as long as the request remains valid) by calling DOFRequest_Throw.

This callback may be NULL if the application does not monitor nor control registrations to any Event (registrations to any event will be automatically accepted).

Parameters
selfThe callback object. This will never be NULL.
operationThe Provide Operation. This will never be NULL.
evtThe Event being Registered. This will never be NULL.
requestA representation of the requestor. This will never be NULL.
Note
The request must be accepted by calling DOFRequestRegister_Return, or rejected via DOFRequest_Throw. All parameters to this callback remain valid and may be referenced by the application until either the end of the callback or the RegisterComplete callback is called, whichever is LATER.
core-c-dof-oal Version 8.0.1 Build 0
2018-01-22