Animadoria at 11:00, 13 May 2022

2022-05-13T11:00:43Z

← Older revision		Revision as of 11:00, 13 May 2022
Line 1:		Line 1:
	{{Protocols/MSNP/MSNP13 ~~Navigation~~}}		{{Protocols/MSNP\|
			section=MSNP13}}

	WLM 8.0 introduces a new feature called Sharing Folders.		WLM 8.0 introduces a new feature called Sharing Folders.

AD: 1 revision imported

2020-05-29T00:23:41Z

1 revision imported

← Older revision	Revision as of 00:23, 29 May 2020
(No difference)

AD: Future

2009-10-03T18:23:26Z

Future

New page

{{Protocols/MSNP/MSNP13 Navigation}}

WLM 8.0 introduces a new feature called Sharing Folders.

= The Client ID =
In order to show to others client that yours supports Sharing Folders, you have to OR its [[Protocols/MSNP/Client ID]] with <code>0x400000</code> (<code>4194304</code>) :
ClientID |= 4194304

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

== Sending ==
This is done via the notification server, with the UUN command, what is a payload command:
UUN (TrId) destination@email.addr.ess 1 7\r\n
message

== Receiving ==
When someone sends you a XML message, the notification server sends :
UBN source@email.addr.ess 1 7\r\n
message

= 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 <code>SNM</code>)
* '''reason''' : A HResult that gives more information (sent only when the '''opcode''' is set to <code>NAK</code> or <code>INFO</code>)

== Synchronization requests ==
They are done with a SNM tag having its '''opcode''' set to <code>SNM</code>.
Example :
<SNM opcode="SNM" csid="{aaaaaaaa-bbbb-cccc-ddee-ffgghhiijjkk}" priority="n" />

== Accepting a request ==
This is done with a SNM tag having its '''opcode''' set to <code>ACK</code>.

== Rejecting a request ==
This is done with a SNM tag having its '''opcode''' set to <code>NAK</code>.
Example :
<SNM opcode="NAK" csid="{aaaaaaaa-bbbb-cccc-ddee-ffgghhiijjkk}" reason="0x80070000" />

== Information ?? ==
The '''opcode''' has been observed to be set to <code>INFO</code>. The meaning of this '''opcode''' is still unknown.
Example :
<SNM opcode="INFO" csid="{aaaaaaaa-bbbb-cccc-ddee-ffgghhiijjkk}" reason="0x8F450005" />

= Generating HResults =
== 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 | | |
+-----+-----------------------------------------+-----------------------------------------------+

== Successes ==
Severity = 0 (0 << 30 = 0x00000000)

== Warnings ==
Severity = 1 (1 << 30 = 0x40000000)

== Errors ==
Severity = 2 (2 << 30 = 0x80000000)
=== 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''

=== When Sharing Folders are unavailable ===
Facility = 0x0F45
Values of <code>Code</code> :
* <code>0x0001</code> : Sharing Folders are disabled
* <code>0x0002</code> : unknown, discovered by sniffing
* <code>0x0005</code> : Sharing Folders are suspended

== Critical errors ==
Severity = 3 (3 << 30 = 0xC0000000)

== Examples ==
* <code>0x80070002</code> : File not found
** <code>Severity = 2</code>
** <code>Facility = 0x0007</code>
** <code>Code = 0x0002</code>
* <code>0x8F450001</code> : Sharing Folders are disabled
** <code>Severity = 2</code>
** <code>Facility = 0x0F45</code>
** <code>Code = 0x0001</code>

=Future=
According to wikipedia, "The Sharing Folder feature has been discontinued in the latest version of Windows Live Messenger (2009), and replaced with access to [[Protocols/MSNP/Windows Live SkyDrive]] instead."

[[Category:MSN]]
[[Category:Protocols/MSNP]]
[[Category:Work_In_Progress]]

Protocols/MSNP/MSNP13/SDrive - Revision history

Animadoria at 11:00, 13 May 2022

AD: 1 revision imported

AD: Future