GetEventRefByName

Purpose

This function returns the event reference for an event.  The event reference is different than an index to a event.  The event reference is only needed for other procedures which explicitly require the event reference ID.

• This will only return the reference to the first event matching the name provided.

Parameters

Parameter: sName
Type: string
Description: This is the event name excluding the group, such as "Wake-Up Time".

Returns

Return value: reference
Type: long (.NET Integer)
Description: This is a numerical event reference ID.