DMessengerPrivateEvents::OnLockResult Event

  • Article

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