DMessengerPrivateEvents::OnLockResult event

[OnLockResult is no longer available for use as of Windows Vista. See Windows Messenger for more information.]

Returns the result of a Lock and Key authentication transaction between a Messenger client and the Microsoft .NET Messenger Service.

Syntax

void OnLockResult(
  [in] long         lCookie,
  [in] VARIANT_BOOL fSucceed = VARIANT_FALSE
);

Parameters

lCookie [in]

LONG that has the same value that the Messenger client passed to the Microsoft .NET Messenger Service as the lCookie parameter of the RequestChallenge method.

fSucceed [in]

VARIANT_BOOL that defines one of the following possible values.

Value Meaning
VARIANT_FALSE
false
The authentication transaction was unsuccessful.
VARIANT_TRUE
true
The authentication transaction was successful.

Return value

This event does not return a value.

Requirements

Minimum supported client
Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
End of client support
Windows XP
End of server support
Windows Server 2003
Product
Messenger 4.5
Header
Msgrpriv.h
IDL
Msgrpriv.idl
DLL
Msnmsgrexe.adeb440d_7847_4f65_80bd_899870ed2ec9

See also

DMessengerPrivateEvents

OnAlertReceived

OnLockChallenge

OnLockEnable

RequestChallenge

SendResponse

Messenger Lock and Key API

Messenger Session Invite and Messenger Private APIs