Share via


IMsgrLock interface

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

Do not use. The IMsgrLock interface implements an API that is used to unlock Licensed Messenger objects.

Members

The IMsgrLock interface inherits from the IUnknown interface. IMsgrLock also has these types of members:

Methods

The IMsgrLock interface has these methods.

Method Description
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 .

Properties

The IMsgrLock interface has these properties.

Property Access type Description
Status
Read-only
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.

Requirements

Minimum supported client
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
Msgsc.dll

See also

MsgrSessionManager

MessengerPriv

DMsgrSessionManagerEvents

DMessengerPrivateEvents

Messenger Lock and Key API

Messenger Session Invite and Messenger Private APIs