DMessengerPrivateEvents::OnLockChallenge event
[OnLockChallenge is no longer available for use as of Windows Vista. See Windows Messenger for more information.]
Notifies a Messenger client that an authentication challenge from a Messenger service has been received.
Syntax
void OnLockChallenge(
[in] long lCookie,
[in] BSTR bstrChallenge
);
Parameters
-
lCookie [in]
-
LONG that has the same value as the one the Messenger client passes to the Messenger service as the lCookie parameter of the RequestChallenge method.
-
bstrChallenge [in]
-
BSTR that is generated by the Messenger service to uniquely identify the challenge transaction.
Return value
This event does not return a value.
Remarks
The Messenger client application receives two parameters. The first parameter, lCookie, enables the Messenger client application to identify the challenge request to which the event corresponds. The value of lCookie is the same as that which is passed to the Messenger service when the application calls the RequestChallenge method. Therefore, it is important that a Messenger client application generates a different value for lCookie each time a challenge request is made to the Messenger service , and for each object that requires a Lock and Key authentication transaction.
The second parameter, bstrChallenge, is generated by the Messenger service . The key used by the Messenger client application is appended to the challenge string and the result is encrypted with an RSA-MD5 Message Digest Algorithm (MD5). For more information, see Messenger Lock and Key API. The MD5 hashed string is used as the bstrResponse of the SendResponse method when the Messenger client application responds to the Messenger service authentication challenge.
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 |
|
| IDL |
|
| DLL |
|