IMsgrLock Interface

  • Article

Deprecated. The IMsgrLock interface implements an API that is used to unlock Licensed Messenger objects.

IMsgrLock Members

RequestChallenge Initiates an authentication challenge-response transaction between a Messenger client and a Messenger service.
SendResponse Sends authentication data from a Messenger client to a Messenger service.
Status Returns the Lock and Key status.

Remarks

The IMsgrLock interface is implemented in the MsgrSessionManager and MessengerPriv objects, both of these objects expose Messenger service APIs and are locked by default. The IMsgrLock interface provides the mechanism that enables an application to programmatically unlock Messenger service APIs.

To unlock one of the objects that expose a Messenger service API, the methods and properties of IMsgrLock are used in conjuction with the notifications fired by the DMsgrSessionManagerEvents and DMessengerPrivateEvents dispinterfaces, depending on which object type is being unlocked. The MsgrSessionManager is an object that exposes Messenger service APIs. If it is created by an application, this object must be unlocked using IMsgrLock before it can be used. For the MsgrSessionManager object, event notifications are fired from the DMsgrSessionManagerEvents dispinterface. For the MessengerPriv object, event notifications are fired from the DMessengerPrivateEvents dispinterface.

If more than one Messenger service object is used in an application, then each object must be unlocked seperately before its interface members can be used. For more information on unlocking objects using IMsgrLock see Messenger Lock and Key API.

Important  IMsgrLock is no longer available in Windows Vista. See Windows Messenger for more information.

Interface Information

Stock Implementation msgsc.dll
Custom Implementation No
Inherits from IUnKnown
Header and IDL files msgrpriv.h, msgrpriv.idl
Minimum availability Messenger 4.5
Minimum operating systems Windows 95, Windows NT 4.0 (requires Internet Explorer 5.0 or later)

See Also

MsgrSessionManager, MessengerPriv, DMsgrSessionManagerEvents, DMessengerPrivateEvents, Messenger Lock and Key API, Messenger Session Invite and Messenger Private APIs