MatchFound method
The MatchFound callback signals that an IWDTFTarget2 instance matches the previously provided IMatchEventSource::SDEL statement.
Syntax
HRESULT MatchFound(
[in] IWDTFTarget2 *pTarget,
[in] IMatchEventSource *pSource
);
Parameters
pTarget [in]
The specific IWDTFTarget2 instance that matches.pSource [in]
The specific IMatchEventSource instance that this event was sent from.
Return value
If you return an error (or throw an exception from script) while receiving the MatchFound callback, the first error will be saved and eventually returned from your call to IWDTFDeviceDepot2::UpdateAndReportMatches. Returning an error will not stop additional MatchFound and IMatchEvents::MatchLost callbacks from being sent.
Remarks
You can enable the MatchFound event by calling IMatchEventSource::Start.
When the MatchFound event is sent, it means that an IWDTFTarget2 object just arrived (or an existing one changed) so that it now matches the IMatchEventSource::SDEL statement that is specified when the IMatchEventSource instance was created.
You will not receive two MatchFound events for a given IWDTFTarget2/IMatchEventSource pair without receiving the appropriate MatchLost event between the two.
See also
IWDTFDeviceDepot2::UpdateAndReportMatches
Send comments about this topic to Microsoft
Build date: 3/12/2012