Prosody DTLS processing: API: sm_dtlsrx_get_event

Prototype Definition

int sm_dtlsrx_get_event(struct sm_dtlsrx_event_parms *eventp)

Parameters

a structure of the following type:

typedef struct sm_dtlsrx_event_parms {
	tSMDTLSrxId dtlsrx;					/* in */
	tSMEventId event;					/* out */
} SM_DTLSRX_EVENT_PARMS;

Description

If the call completes successfully event will hold a pointer to the tSMEventId belonging to dtlsrx. The tSMEventId is valid until the DTLS[rx] is destroyed using sm_dtlsrx_destroy(). This event will be signalled when a status change occurs on the DTLS[rx]. When the event is signalled the user must call sm_dtlsrx_status() to discover the nature of the status change.

Fields

dtlsrx: The DTLS[rx]
event: The event identifier

Returns

0 if call completed successfully, otherwise a standard error such as:

ERR_SM_DEVERR - device error

This function is part of the Prosody DTLS processing API.