%docentities; ]>

Register a new callback to the dialog. Meaning of the parameters is as follows: struct dlg_cell* dlg - dialog to register callback to. If maybe NULL only for DLGCB_CREATED callback type, which is not a per dialog type. int type - types of callbacks; more types may be register for the same callback function; only DLGCB_CREATED must be register alone. Possible types: DLGCB_LOADED DLGCB_CREATED - called when a new dialog is created - it's a global type (not associated to any dialog) DLGCB_FAILED - called when the dialog was negatively replied (non-2xx) - it's a per dialog type. DLGCB_CONFIRMED_NA - called when the dialog is confirmed (2xx replied) but the setup-concluding ACK message from the caller is yet pending - it's a per dialog type. DLGCB_CONFIRMED - called when the dialog is confirmed (2xx replied) and the setup-concluding ACK message from the caller has been seen - it's a per dialog type. DLGCB_REQ_WITHIN - called when the dialog matches a sequential request (excluding setup-concluding ACK messages which are handled in DLGCB_CONFIRMED) - it's a per dialog type. DLGCB_TERMINATED - called when the dialog is terminated via BYE - it's a per dialog type. DLGCB_TERMINATED_CONFIRMED - called when response to a BYE request is received - it's a per dialog type. DLGCB_EXPIRED - called when the dialog expires without receiving a BYE - it's a per dialog type. DLGCB_EARLY - called when the dialog is created in an early state (18x replied) - it's a per dialog type. DLGCB_RESPONSE_FWDED - called when the dialog matches a reply to the initial INVITE request - it's a per dialog type. DLGCB_RESPONSE_WITHIN - called when the dialog matches a reply to a subsequent in dialog request - it's a per dialog type. DLGCB_MI_CONTEXT - called when the mi dlg_list_ctx command is invoked - it's a per dialog type. DLGCB_SPIRALED - called when the dialog matches a spiraling request - it's a per dialog type. DLGCB_DESTROY dialog_cb cb - callback function to be called. Prototype is: void (dialog_cb) (struct dlg_cell* dlg, int type, struct dlg_cb_params * params); void *param - parameter to be passed to the callback function. param_free callback_param_free - callback function to be called to free the param. Prototype is: void (param_free_cb) (void *param);

Terminate a Dialog Meaning of parameters is as follows: struct dlg_cell* dlg - dialog to terminate. str* hdrs - string containg extra headers (full format) to be added to the BYE requests of the dialog.