DMessengerPrivateEvents::OnLockResult Event
Deprecated. Returns the result of a Lock and Key authentication transaction between a Messenger client and the Microsoft .NET Messenger Service.
Syntax
void OnLockResult( long lCookie, VARIANT_BOOL fSucceed );
Parameters
- lCookie
[in] LONG that has the same value that the Messenger client passed to the .NET Messenger Service as the lCookie parameter of the IMsgrLock::RequestChallenge method.- fSucceed
[in] VARIANT_BOOL that defines one of the following possible values.
- VARIANT_FALSE
Default. The authentication transaction was unsuccessful.VARIANT_TRUE
The authentication transaction was successful.
Return Value
No return value.
Event DISPID
DISPID_ONLOCKRESULT
The DISPID for this event is defined in msgrpriv.h. Use this value to identify the event handler when implementing IDispatch::Invoke.
Remarks
Important DMessengerPrivateEvents::OnLockResult is no longer available in Windows Vista. See Windows Messenger for more information.
See Also
DMessengerPrivateEvents::OnAlertReceived, DMessengerPrivateEvents::OnLockChallenge, DMessengerPrivateEvents::OnLockEnable, IMsgrLock::RequestChallenge, IMsgrLock::SendResponse, Messenger Lock and Key API, Messenger Session Invite and Messenger Private APIs