Description.
This method drops an event, given a reference to an
Event object.
Signature.
int dropEvent
(
const char* name,
int force = 0
)
Parameters. This method takes two parameters:
The name of the event to be
dropped, as a string.
By default, dropEvent() fails if the
event specified does not exist. You can override this
behavior by passing any nonzero value for the (optional)
force argument; in this case
no check is made as to whether there actually is such an
event, and an error is returned only if the event exists
but it was for whatever reason not possible to drop it.
Return Value.
0 on success, -1 on
failure.
