Personal tools

MSNP13:SDrive

From MSNPiki

MSN Protocol Version 13

WLM 8.0 introduces a new feature called Sharing Folders.

Contents

[edit]

The Client ID

In order to show to others client that yours supports Sharing Folders, you have to OR its Client ID with 0x400000 (4194304) : 

ClientID |= 4194304
[edit]

XML messages

They are exchanged through the notification server. Warning : you CANNOT use this method to exchange plain-text messages.

[edit]

Sending

This is done via the notification server, with the UUN command, what is a payload command (replace the first 0 with your next available TrID) : 

UUN 0 destination@email.addr.ess 1 7\r\n
message
[edit]

Receiving

When someone sends you a XML message, the notification server sends : 

UBN source@email.addr.ess 1 7\r\n
message
[edit]

The SNM tag

It takes these attributes :

  • opcode : The operation code
  • csid : A GUID that identifies the operation
  • priority : Still unknown (sent only when the opcode is set to SNM)
  • reason : A HResult that gives more information (sent only when the opcode is set to NAK or INFO)
[edit]

Synchronization requests

They are done with a SNM tag having its opcode set to SNM. Example : 

<SNM opcode="SNM" csid="{aaaaaaaa-bbbb-cccc-ddee-ffgghhiijjkk}" priority="n" />
[edit]

Accepting a request

This is done with a SNM tag having its opcode set to ACK.

[edit]

Rejecting a request

This is done with a SNM tag having its opcode set to NAK. Example : 

<SNM opcode="NAK" csid="{aaaaaaaa-bbbb-cccc-ddee-ffgghhiijjkk}" reason="0x80070000" />
[edit]

Information ??

The opcode has been observed to be set to INFO. The meaning of this opcode is still unknown. Example : 

<SNM opcode="INFO" csid="{aaaaaaaa-bbbb-cccc-ddee-ffgghhiijjkk}" reason="0x8F450005" />
[edit]

Generating HResults

[edit]

Some expressions

Logical (OR/AND/LSH) expression : 

HResult = (Severity << 30) | ((Facility & 0x3FFF) << 16) | (Code & 0xFFFF)

"Graphical" expression : 

+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
|Sever|                Facility                 |                     Code                      |
| ity |                                         |                                               |
+-----+-----------------------------------------+-----------------------------------------------+
[edit]

Successes 

Severity = 0 (0 << 30 = 0x00000000)
[edit]

Warnings 

Severity = 1 (1 << 30 = 0x40000000)
[edit]

Errors 

Severity = 2 (2 << 30 = 0x80000000)
[edit]

When an operation raises a Windows error 

Facility = 7
Code     = WindowsErrorCode

You can get an error description for most of the Windows errors with the command-line utility Net.exe (case-insensitive) : 

Net HelpMsg WindowsErrorCode
[edit]

When Sharing Folders are unavailable 

Facility = 0x0F45

Values of Code :

  • 0x0001 : Sharing Folders are disabled
  • 0x0002 : unknown, discovered by sniffing
  • 0x0005 : Sharing Folders are suspended
[edit]

Critical errors 

Severity = 3 (3 << 30 = 0xC0000000)
[edit]

Examples

  • 0x80070002 : File not found
    • Severity =      2
    • Facility = 0x0007
    • Code  = 0x0002
  • 0x8F450001 : Sharing Folders are disabled
    • Severity =      2
    • Facility = 0x0F45
    • Code  = 0x0001
Retrieved from "http://msnpiki.msnfanatic.com/index.php/MSNP13:SDrive"
Reference