msnp-wiki/docs/errors_and_hresults.md

115 lines
13 KiB
Markdown
Raw Normal View History

# Error codes and HRESULTs
The following is a list of all **known** MSNP error codes and related `HRESULT` values.
If you know any error that isn't listed, please contact me.
For valid MSNP commands, read the [Table of Commands](table_of_commands.md).
## MSNP error codes
| `MSNP ERROR CODE` | related `HRESULT` value | related `HRESULT`'s name | `DRAFT` name | Description / Known reason? |
| ----- | ------------ | -------------------------------------- | ------------------------------ | ------------------ |
| `200` | N/A | N/A | `ERR_SYNTAX_ERROR` | Syntax error. |
| `201` | `0x81000435` | `MSGR_E_MSNP_INVALID_PARAMETER` | `ERR_INVALID_PARAMETER` | Invalid parameter in command. |
| `203` | `0x810003c0` | `MSGR_E_INVALID_FEDERATED_USER` | N/A | ? |
| `204` | `0x8100037c` | `MSGR_E_UNROUTABLE_USER` | N/A | ? |
| `205` | `0x8100030a` | `MSGR_E_USER_NOT_FOUND` | `ERR_INVALID_USER` | The user is invalid. |
| `206` | `0x8100030a` | `MSGR_E_USER_NOT_FOUND` | `ERR_FQDN_MISSING` | The domain name of the user handle is missing. |
| `207` | `0x81000304` | `MSGR_E_ALREADY_LOGGED_ON` | `ERR_ALREADY_LOGIN` | You are already logged in. |
| `208` | `0x8100030a` | `MSGR_E_USER_NOT_FOUND` | `ERR_INVALID_USERNAME` | The username of the user handle is invalid. |
| `209` | `0x81000324` | `MSGR_E_INVALID_FRIENDLY_NAME` | `ERR_INVALID_FRIENDLY_NAME` | You cannot use that friendly name. |
| `210` | `0x81000307` | `MSGR_E_LIST_FULL` | `ERR_LIST_FULL` | That list is full. |
| `212` | `0x8100030d` | `MSGR_E_UNEXPECTED` | N/A | ? |
| `213` | `0x81000392` | `MSGR_E_USER_DOESNT_EXIST` | N/A | ? |
| `215` | `0x8100030b` | `MSGR_E_ALREADY_IN_LIST` | `ERR_ALREADY_THERE` | That user is already added to that list. |
| `216` | `0x8100030a` | `MSGR_E_USER_NOT_FOUND` | `ERR_NOT_ON_LIST` | This user is not on any of your lists. |
| `217` | `0x81000430` | `MSGR_E_MSNP_NOT_ACCEPTING_IMS` | N/A | That user is currently not accepting instant messages. |
| `218` | `0x01000301` | `MSGR_S_ALREADY_IN_THE_MODE` | `ERR_ALREADY_IN_THE_MODE` | You are already in the mode specified. |
| `219` | `0x81000431` | `MSGR_E_MSNP_ALREADY_IN_OPPOSITE_LIST` | `ERR_ALREADY_IN_OPPOSITE_LIST` | The user is in a mutually exclusive list and therefore can not be added to the specified one. |
| `220` | `0x81000335` | `MSGR_E_NOT_ACCEPTING_PAGES` | N/A | ? |
| `232` | `0x810003b5` | `MSGR_E_INVALID_MSISDN` | N/A | ? |
| `233` | `0x810003b6` | `MSGR_E_UNKNOWN_MSISDN` | N/A | ? |
| `234` | `0x81000439` | `MSGR_E_MSNP_UNKNOWN_KEITAI_DOMAIN` | N/A | ? |
| `240` | `0x8100043b` | `MSGR_E_MSNP_INVALID_XML` | N/A | ? |
| `241` | `0x8100043a` | `MSGR_E_MSNP_INVALID_XML_DATA` | N/A | ? |
| `280` | `0x81000436` | `MSGR_E_MSNP_SWITCHBOARD_FAILED` | `ERR_SWITCHBOARD_FAILED` | ? |
| `281` | N/A | N/A | `ERR_NOTIFY_XFR_FAILED` | ? |
| `300` | N/A | N/A | `ERR_REQUIRED_FIELDS_MISSING` | ? |
| `302` | N/A | N/A | `ERR_NOT_LOGGED_IN` | You need to log in to perform that action. |
| `400` | `0x81000376` | `MSGR_E_ABCH_READ_ONLY` | N/A | Your Address Book is read-only and can not be used. |
| `402` | `0x81000377` | `MSGR_E_ABCH_TOO_BUSY` | N/A | The Address Book service is currently too busy. |
| `403` | `0x81000378` | `MSGR_E_ABCH_UNAVAILABLE` | N/A | The Address Book service is currently unavaliable. |
| `413` | `0x810003a5` | `MSGR_E_SUBSCRIPTION_NEEDED` | N/A | ? |
| `414` | `0x810003a6` | `MSGR_E_SUBSCRIPTION_DISABLED` | N/A | ? |
| `416` | `0x810003c1` | `MSGR_E_MARKET_DISABLED` | N/A | ? |
| `417` | `0x810003c2` | `MSGR_E_DISABLED_EVERYWHERE` | N/A | ? |
| `418` | `0x810003c3` | `MSGR_E_TRY_AGAIN_LATER` | N/A | ? |
| `419` | `0x810003c4` | `MSGR_E_NO_MARKET_SPECIFIED` | N/A | ? |
| `420` | `0x810003cc` | `MSGR_E_INVITE_REQUIRED` | N/A | You need an invitation to use this version of the Official Client. |
| `500` | `0x810003a8` | `MSGR_E_INTERNAL_SERVER_ERROR` | `ERR_INTERNAL_SERVER` | Internal server error. |
| `501` | N/A | N/A | `ERR_DB_SERVER` | ? |
| `503` | `0x80004005` | `MSGR_E_FAIL` / `E_FAIL` | N/A | Unspecified failure. |
| `504` | `0x810003c5` | `MSGR_E_UPS_UNAVAILABLE` | N/A | ? |
| `505` | `0x810003c6` | `MSGR_E_SCS_UNAVAILABLE` | N/A | ? |
| `508` | `0x81000433` | `MSGR_E_MSNP_FEDERATED_SERVER_ERROR` | N/A | ? |
| `509` | `0x81000434` | `MSGR_E_MSNP_UUM_ERROR` | N/A | ? |
| `510` | N/A | N/A | `ERR_FILE_OPERATION` | ? |
| `511` | `0x81000603` | `MSGR_E_PPLATFORM_SERVER_511` | N/A | ? |
| `520` | `0x810003a8` | `MSGR_E_INTERNAL_SERVER_ERROR` | `ERR_MEMORY_ALLOC` | ? |
| `540` | `0x8100036d` | `MSGR_E_LOCKANDKEY_FAILED` | N/A | ? |
| `600` | `0x8100030e` | `MSGR_E_SERVER_TOO_BUSY` | `ERR_SERVER_BUSY` | ? |
| `601` | `0x81000314` | `MSGR_E_SERVER_UNAVAILABLE` | `ERR_SERVER_UNAVAILABLE` | The server is unavaliable at this time. |
| `602` | N/A | N/A | `ERR_PEER_NS_DOWN` | ? |
| `603` | N/A | N/A | `ERR_DB_CONNECT` | ? |
| `604` | N/A | N/A | `ERR_SERVER_GOING_DOWN` | ? |
| `606` | `0x81000339` | `MSGR_E_PAGING_UNAVAILABLE` | N/A | ? |
| `707` | N/A | N/A | `ERR_CREATE_CONNECTION` | ? |
| `710` | `0x81000339` | `MSGR_E_PAGING_UNAVAILABLE` | N/A | ? |
| `711` | N/A | N/A | `ERR_BLOCKING_WRITE` | ? |
| `712` | N/A | N/A | `ERR_SESSION_OVERLOAD` | ? |
| `713` | N/A | N/A | `ERR_USER_TOO_ACTIVE` | You are being too active. You have been rate limited. |
| `714` | N/A | N/A | `ERR_TOO_MANY_SESSIONS` | ? |
| `715` | `0x81000438` | `MSGR_E_MSNP_NOT_EXPECTED` | `ERR_NOT_EXPECTED` | Command not expected at that time. |
| `717` | N/A | N/A | `ERR_BAD_FRIEND_FILE` | ? |
| `718` | `0x8100035a` | `MSGR_E_RESTRICTED_USER` | N/A | ? |
| `719` | `0x810003c7` | `MSGR_E_FEDERATED_SESSION` | N/A | ? |
| `726` | `0x8100037d` | `MSGR_E_USER_FEDERATED` | N/A | ? |
| `729` | `0x8100030e` | `MSGR_E_SERVER_TOO_BUSY` | N/A | ? |
| `800` | `0x81000398` | `MSGR_E_RATE_LIMIT_EXCEEDED` | N/A | You are being rate limited. |
| `910` | `0x8100030e` | `MSGR_E_SERVER_TOO_BUSY` | N/A | The server is too busy to authenticate your user. |
| `911` | `0x81000395` | `MSGR_E_MSNP_911` | `ERR_AUTHENTICATION_FAILED` | Generic authentication failure. |
| `913` | `0x8100043c` | `MSGR_E_MSNP_NOT_ALLOWED_WHEN_OFFLINE` | `ERR_NOT_ALLOWED_WHEN_OFFLINE` | You may not do that while appearing offline or in semi-offline mode. |
| `917` | `0x81000327` | `MSGR_E_INVALID_DOMAIN` | N/A | The domain specified at authentication is invalid. |
| `918` | `0x810003a8` | `MSGR_E_INTERNAL_SERVER_ERROR` | N/A | ? |
| `919` | `0x810003a8` | `MSGR_E_INTERNAL_SERVER_ERROR` | N/A | ? |
| `920` | `0x81000326` | N/A | `ERR_NOT_ACCEPTING_NEW_USERS` | The server is too full and is no longer accepting new authentication requests. |
| `921` | `0x8100030e` | `MSGR_E_SERVER_TOO_BUSY` | N/A | The server is too busy to authenticate your user. |
| `922` | `0x8100030e` | `MSGR_E_SERVER_TOO_BUSY` | N/A | ? |
| `923` | `0x81000331` | `MSGR_E_CHILD_WITHOUT_CONSENT` | N/A | Child account does not have authorization to use the Messenger Service. |
| `924` | `0x81000336` | `MSGR_E_EMAIL_PASSPORT_NOT_VALIDATED` | N/A | You need to verify your account before using the Messenger Service. |
| `926` | `0x81000359` | `MSGR_E_MANAGED_USER_INVALID_CVR` | N/A | The account's permissions could not be verified. |
| `927` | `0x8100035a` | `MSGR_E_RESTRICTED_USER` | N/A | The parent or guardian of this account has blocked access of the Messenger Service using this account. |
| `928` | `0x81000303` | `MSGR_E_INVALID_PASSWORD` | N/A | The password provided is invalid. |
| `929` | `0x81000385` | `MSGR_E_LOCKANDKEY_FAILED_FOR_MCAA` | N/A | ? |
| `930` | `0x8100037b` | `MSGR_E_FEDERATED_DOMAIN` | N/A | This account belongs to a enterprise domain and can not be used on the Messenger Service. |
| `934` | `0x81000410` | `MSGR_E_FSS_USER_NO_ACCESS` | N/A | ? |
## Common HRESULTS without related MSNP error codes
| related `HRESULT` value | related `HRESULT`'s name | Description / Known reason? |
| ------------ | ------------------------------------------------- | ------------- |
| `0x80004005` | `E_FAIL` | Unspecified failure. |
| `0x00048802` | `PPCRL_AUTHSTATE_S_AUTHENTICATED_OFFLINE` | You are logged in, but working offline. |
| `0x00048803` | `PPCRL_AUTHSTATE_S_AUTHENTICATED_PASSWORD` | You are logged in using a password. |
| `0x80048810` | `PPCRL_AUTHREQUIRED_E_PASSWORD` | Please input your password. |
| `0x80048800` | `PPCRL_AUTHSTATE_E_UNAUTHENTICATED` | You are not logged in. |
| `0x80048801` | `PPCRL_AUTHSTATE_E_EXPIRED` | Your session has expired. Please log in again. |
| `0x80048820` | `PPCRL_REQUEST_E_AUTH_SERVER_ERROR` | Authentication server error. |
| `0x80048821` | `PPCRL_REQUEST_E_BAD_MEMBER_NAME_OR_PASSWORD` | Invalid email address or password. |
| `0x80048823` | `PPCRL_REQUEST_E_PASSWORD_LOCKED_OUT` | This account's password is disabled and needs to be reset. |
| `0x80048825` | `PPCRL_REQUEST_E_TOU_CONSENT_REQUIRED` | You must accept the service's Terms of Use before using this account.|
| `0x80048826` | `PPCRL_REQUEST_E_FORCE_RENAME_REQUIRED` | Your account details needs to be revised. |
| `0x80048827` | `PPCRL_REQUEST_E_FORCE_CHANGE_PASSWORD_REQUIRED` | Your account's password needs to be changed. |
| `0x80048831` | `PPCRL_REQUEST_E_PASSWORD_EXPIRED` | Your account's password has expired and needs to be changed. |
| `0x80048836` | `PPCRL_REQUEST_E_EMAIL_VALIDATION_REQUIRED` | Your account's e-mail address must be verified. |
| `0x80070002` | System Error `ERROR_FILE_NOT_FOUND` | A file could not be found. |
| `0x80070057` | System Error `ERROR_INVALID_PARAMETER` | One or more parameters have invalid values.
| `0x80072f7d` | System Error `ERROR_WINHTTP_SECURE_CHANNEL_ERROR` | Any possible secure channel (SSL) error from WinHTTP. |