Protocols/MSNP/Commands/CVR
| MSNP Protocol |
| Introduction • Terms • Clients |
| Reference |
| Error List • Commands • Relying Party Suite • Spotlife |
| Services |
| XMPP • HTTP Gateway • Tabs • Activities |
| Documentation |
| Development Tools • MSNP Grid |
| Polygamy • URLs used by MSN |
| Documents |
| Protocol Versions |
| Version 21 |
| Version 18 |
| Version 16 |
| Version 15 |
| Version 14 |
| Version 13 |
| Version 12 |
| Version 11 |
| Version 9 |
| Version 8 |
| Version 2 |
| MSNC |
| Introduction • P2P • Object Descriptor • Display Pictures • File Transfer |
| Scenarios |
| Microsoft Messenger for Mac |
| MSNP on WebTV (MSNTV) |
Contents
CVR and CVQ
This command is used to send information about the client and it's operating system to the server. For the official client, the server then responds with the recommended version of the client to use, the minimum safe version as well as 2 URLs, one a link to the download page for the updated version and one to a page with information about the updated version. If the client is unrecognised by the server, the recommended version is 1.0.0000 and the minimum version is the version number sent by the client in the initial CVR.
Both CVQ and CVR seem synonymous with each other in MSNP and are used interchangeably in this article.
Sent to server
Description
CVR trid localeId osType osVer cpuArch libraryName clientVer clientName passport
Parameters
| Name | Type | Example Value | Summary |
|---|---|---|---|
| trid | Transaction ID | 1 | |
| localeId | Hexadecimal number | "0x0409" for English (United States) | The Protocols/MSNP/Locale ID of the client |
| osType | String | "win" for Windows 9x, "winnt" for Windows NT, 2K, XP, Vista, etc | Operating system family of the client |
| osVer | Decimal number | "4.10" for Windows 98, "5.1" for Windows XP | Major and Minor version numbers of the client's OS |
| arch | String | "i386" for x86 | Client hardware platform |
| libraryName | String |
|
Name of your client's MSNP library (not the name of the client itself) |
| clientVer | 3-tuple version | "6.0.0602" | Version of your client |
| clientName | String | "MSMSGS" (MSN Messenger), "WindowsMessenger" (Windows Messenger) | Name of the client software. Note that both MSN Messenger 4.x and Windows Messenger 4.x used the same MSNP library, hence why they both sent "MSMSGS" as the libraryName parameter |
| passport | Email address | "someone@example.com" | The user's userHandle/passport email address. This parameter was added in MSNP8. |
Server returns
Description
CVR trid rec_ver rec_ver2 min_ver dl_url info_url
Parameters
- trid: Transaction ID
- rec_ver: Recommended client version, "1.0.0000" for unrecognised clients
- rec_ver2: Always identical to rec_ver
- min_ver: Minimum safe version, current version for unrecognised clients
- dl_url: URL to latest version of client
- info_url: URL with information about client
Other notes
Like with any other command, the server will reply to a CVR command with a CVR reply. For some reason, though, the official client would be just as happy if you replaced CVR with CVQ in the reply.
