IRobot::GetEventIDFromName

Finds the EventID of an event given its name

HRESULT IRobot::GetEventIDFromName (
     LPCTSTR name,
     PEventID id,
     PEventID antiID
)

Parameters
name
Name of the event to find
id
Returns the ID of the event
antiID
Returns the ID of the anti-event, if it exists

Return Values
ValueMeaning
S_OKEvent ID returned
E_POINTERThe id pointer is NULL
E_INVALIDARGOne of the arguements is invalid
E_FAILCannot find the specified event

Remarks
If the name is prefixed with a plus (+) sign, only the event ID is returned. If the name is prefixed with a minus (-) sign, only the anti event ID is returned. Otherwise the event ID is returned, and the anti ID is returned if the anti-event exists