DMsgrSessionManagerEvents::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 mdispid.h. Use this value to identify the event handler when implementing IDispatch::Invoke.

Remarks

Important  DMsgrSessionManagerEvents::OnLockResult is no longer available in Windows Vista. See Windows Messenger for more information.

See Also

DMsgrSessionManagerEvents::OnLockChallenge, DMsgrSessionManagerEvents::OnLockEnable, IMsgrLock::RequestChallenge, Messenger Session Invite and Messenger Private APIs, Messenger Lock and Key API