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 |
|
IDL |
|
DLL |
|