EnhEvents.FindHandle

[This is preliminary documentation and subject to change.]

The FindHandle property returns a reference to the event that has the specified handle. This property is read-only.

Syntax

Set oEvent = object.FindHandle ( lHandle ) 
 

Parts

object

Object expression that resolves to an EnhEvents object.

lHandle

Long that contains the event handle. This value will be compared to each event's EnhEvent.Handle property until a match is found. If a match is not found, FindHandle returns an error

oEvent

EnhEvent that receives the event specified by lHandle.

QuickInfo

  Windows NT: Unsupported.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in stream.idl.
  Import Library: Included as a resource in stream.dll.
  Unicode: Yes.

See Also

EnhEvents.FindTime

Examples

The following example saves a handle to an event in the enhancement stream, and then uses FindHandle to recall that event.

'Declare variables
Dim Ev As IEnhEvents
Dim e As IEnhEvent
Dim lHandle As Long
 
'create the collection
Set Ev = New EnhEvents
 
'add an event to the collection
Ev.Add 15, "EventA"
 
'save a handle to EventA, 
'(which is currently the last-added event)
lHandle = Ev.LastAdd.Handle
 
... 
 
'recall EventA from the collection using the previously-saved handle
Set e = Ev.FindHandle(lHandle)