122 lines
4.5 KiB
Markdown
122 lines
4.5 KiB
Markdown
# Introduction
|
|
`ILN` is a command introduced with [MSNP2](../versions/msnp2.md).
|
|
|
|
It is a Notification Server command, without a response payload.
|
|
|
|
Specifies that a user was already online by the time the client was.
|
|
For the version of this command without the Transaction ID that is sent at any time, read [NLN](nln.md).
|
|
|
|
This command is sent after the initial [CHG](chg.md) command, using it's Transaction ID.
|
|
It may also be sent as a follow-up to a [ADD](add.md), ADC or ADL command, using it's Transaction ID.
|
|
|
|
# Client/Request
|
|
This command can not be sent from the client.
|
|
|
|
# Server/Response
|
|
`ILN TrID status user-handle {network-id} friendly-name {client-capabilities{:extended-client-capabilities}} {msnobj} {presence-icon-url}`
|
|
|
|
Where `status` is any of the defined statuses:
|
|
* `NLN`: Online
|
|
* `BSY`: Busy
|
|
* `IDL`: Idle
|
|
* `BRB`: Be Right Back
|
|
* `AWY`: Away
|
|
* `PHN`: On The Phone
|
|
* `LUN`: Out To Lunch
|
|
* `HDN`: Appear Offline (previously Invisible, Valid but should never be sent.)
|
|
* `FLN`: Offline (Valid but should never be sent.)
|
|
|
|
Where `user-handle` is the relevant user's handle.
|
|
|
|
Where `network-id` is the Network Identification Number. Added since [MSNP14](../versions/msnp14.md).
|
|
|
|
Where `friendly-name` is the relevant user's friendly name.
|
|
|
|
Where `client-capabilities` are the relevant user's Client Capabilities. Optional? Added since [MSNP8](../versions/msnp8.md).
|
|
|
|
Where `extended-client-capabilities` are the relevant user's Extended Client Capabilities.
|
|
Optional. Added since [MSNP16](../versions/msnp16.md).
|
|
|
|
Where `msnobj` is the MSNObject the relevant user has set. Optional. Added since [MSNP9](../versions/msnp9.md).
|
|
|
|
Where `presence-icon-url` is an image that is rendered to this client that replaces the default user icon.
|
|
Optional. Added since [MSNP14](../versions/msnp14.md).
|
|
|
|
# Examples
|
|
|
|
## Wihout anything special
|
|
```
|
|
C: CHG 1 NLN
|
|
S: CHG 1 NLN
|
|
S: ILN 1 NLN anotheruser@example.com another%20user
|
|
```
|
|
|
|
## With Client Capabilities
|
|
*Since [MSNP8](../versions/msnp8.md).*
|
|
```
|
|
C: CHG 2 NLN 1
|
|
S: CHG 2 NLN 1
|
|
S: ILN 2 NLN anotheruser@example.com another%20user 0
|
|
```
|
|
|
|
## With a MSNObject
|
|
*Since [MSNP9](../versions/msnp9.md).*
|
|
|
|
*NOTE: This has been line-breaked.
|
|
Lines beginning with `..` followed by a space are continuations of the previous line.*
|
|
```
|
|
C: CHG 3 NLN 268435500
|
|
S: CHG 3 NLN 268435500
|
|
S: ILN 3 NLN anotheruser@hotmail.com another%20user 268435500 %3Cmsnobj%20Creator%3D%22anotherdude%40hotmail.com%22
|
|
.. %20Size%3D%2225235%22%20Type%3D%223%22
|
|
.. %20Location%3D%22uexA4DE.dat%22%20Friendly%3D%22AAA%3D%22
|
|
.. %20SHA1D%3D%22vP1ppB+xiFQ8ceZivRe0uCaYLIU%3D%22
|
|
.. %20SHA1C%3D%22PApbbjkbDSGrt3ybGHRKNaZ8s%2Fw%3D%22%2F%3E
|
|
```
|
|
|
|
## With Network IDs and Presence Icon URLs
|
|
*Since [MSNP14](../versions/msnp14.md).*
|
|
|
|
*NOTE: This has been line-breaked.
|
|
Lines beginning with `..` followed by a space are continuations of the previous line.*
|
|
```
|
|
C: CHG 4 NLN insert-wlm-8-cid-here
|
|
S: CHG 4 NLN insert-wlm-8-cid-here
|
|
S: ILN 4 NLN anotheruser@hotmail.com 1 another%20user insert-wlm-8-cid-here %3Cmsnobj%20Creator%3D%22anotherdude%40hotmail.com%22
|
|
.. %20Size%3D%2225235%22%20Type%3D%223%22
|
|
.. %20Location%3D%22uexA4DE.dat%22%20Friendly%3D%22AAA%3D%22
|
|
.. %20SHA1D%3D%22vP1ppB+xiFQ8ceZivRe0uCaYLIU%3D%22
|
|
.. %20SHA1C%3D%22PApbbjkbDSGrt3ybGHRKNaZ8s%2Fw%3D%22%2F%3E
|
|
.. http://example.com/interop/online.png
|
|
```
|
|
|
|
## With Extended Client Capabilities
|
|
*Since [MSNP16](../versions/msnp16.md).*
|
|
|
|
*NOTE: This has been line-breaked.
|
|
Lines beginning with `..` followed by a space are continuations of the previous line.*
|
|
```
|
|
C: CHG 5 NLN 2789003324:48
|
|
S: CHG 5 NLN 2789003324:48
|
|
S: ILN 5 NLN anotheruser@hotmail.com 1 another%20user 2789003324:48 %3Cmsnobj%20Creator%3D%22anotherdude%40hotmail.com%22
|
|
.. %20Size%3D%2225235%22%20Type%3D%223%22
|
|
.. %20Location%3D%22uexA4DE.dat%22%20Friendly%3D%22AAA%3D%22
|
|
.. %20SHA1D%3D%22vP1ppB+xiFQ8ceZivRe0uCaYLIU%3D%22
|
|
.. %20SHA1C%3D%22PApbbjkbDSGrt3ybGHRKNaZ8s%2Fw%3D%22%2F%3E
|
|
.. http://example.com/interop/online.png
|
|
```
|
|
|
|
## Invalid context
|
|
*Inherited from being an unimplemented command.*
|
|
```
|
|
C: ILN 6 FLN example@hotmail.com example%20user
|
|
```
|
|
|
|
Server disconnects client.
|
|
|
|
# Known changes
|
|
* [MSNP8](../versions/msnp8.md): Added a parameter for Client Capabilities.
|
|
* [MSNP9](../versions/msnp9.md): Added a parameter for the MSNObject.
|
|
* [MSNP14](../versions/msnp14.md): Added a way to override the default presense icon, and added a new non-optional Network ID parameter.
|
|
* [MSNP16](../versions/msnp16.md): Added Extended Client Capabilities support to the Client Capabilities parameter, delimited by a colon.
|