pccapiutils.cs

以前做NOKIA手机与PC通信时所参考的源代码,里面包括两个程序,一个是手机文件夹浏览源码,另一个手机SIS安装程序.

                    functionReturnValue = "ECONA_MEDIA_IS_NOT_ACTIVE: Target media is busy (or not ready yet).";
                    break;
                case PCCSErrors.ECONA_PORT_OPEN_FAILED:
                    functionReturnValue = "ECONA_PORT_OPEN_FAILED: Cannot open the changed COM port.";
                    break;

                // Device pairing releated errors:
                case PCCSErrors.ECONA_DEVICE_PAIRING_FAILED:
                    functionReturnValue = "ECONA_DEVICE_PAIRING_FAILED: Pairing failed.";
                    break;
                case PCCSErrors.ECONA_DEVICE_PASSWORD_WRONG:
                    functionReturnValue = "ECONA_DEVICE_PASSWORD_WRONG: Wrong password on device.";
                    break;
                case PCCSErrors.ECONA_DEVICE_PASSWORD_INVALID:
                    functionReturnValue = "ECONA_DEVICE_PASSWORD_INVALID: Password includes invalid characters or is missing.";
                    break;

                // File System errors:
                case PCCSErrors.ECONA_ALL_LISTED:
                    functionReturnValue = "ECONA_ALL_LISTED: All items are listed.";
                    break;
                case PCCSErrors.ECONA_MEMORY_FULL:
                    functionReturnValue = "ECONA_MEMORY_FULL: Device memory full.";
                    break;

                // File System errors for file functions:
                case PCCSErrors.ECONA_FILE_NAME_INVALID:
                    functionReturnValue = "ECONA_FILE_NAME_INVALID: File name contains invalid characters in Device or PC.";
                    break;
                case PCCSErrors.ECONA_FILE_NAME_TOO_LONG:
                    functionReturnValue = "ECONA_FILE_NAME_TOO_LONG: File name contains too many characters in Device or PC.";
                    break;
                case PCCSErrors.ECONA_FILE_ALREADY_EXIST:
                    functionReturnValue = "ECONA_FILE_ALREADY_EXIST: File already exists in Device or PC.";
                    break;
                case PCCSErrors.ECONA_FILE_NOT_FOUND:
                    functionReturnValue = "ECONA_FILE_NOT_FOUND: File does not exist in Device or PC.";
                    break;
                case PCCSErrors.ECONA_FILE_NO_PERMISSION:
                    functionReturnValue = "ECONA_FILE_NO_PERMISSION: Not allowed to perform required operation to file in device or PC.";
                    break;
                case PCCSErrors.ECONA_FILE_COPYRIGHT_PROTECTED:
                    functionReturnValue = "ECONA_FILE_COPYRIGHT_PROTECTED: Not allowed to perform required operation to file in device or PC.";
                    break;
                case PCCSErrors.ECONA_FILE_BUSY:
                    functionReturnValue = "ECONA_FILE_BUSY: Other application has reserved file in device or PC.";
                    break;
                case PCCSErrors.ECONA_FILE_TOO_BIG_DEVICE:
                    functionReturnValue = "ECONA_FILE_TOO_BIG_DEVICE: Device rejected the operation because file size is too big.";
                    break;
                case PCCSErrors.ECONA_FILE_TYPE_NOT_SUPPORTED:
                    functionReturnValue = "ECONA_FILE_TYPE_NOT_SUPPORTED: Device rejected the operation because file has unsupported type.";
                    break;
                case PCCSErrors.ECONA_FILE_NO_PERMISSION_ON_PC:
                    functionReturnValue = "ECONA_FILE_NO_PERMISSION_ON_PC: Not allowed to perform required operation to file in PC.";
                    break;
                case PCCSErrors.ECONA_FILE_EXIST:
                    functionReturnValue = "ECONA_FILE_EXIST: File move or rename: File is copied to target path with new name but removing the source file failed.";
                    break;
                case PCCSErrors.ECONA_FILE_CONTENT_NOT_FOUND:
                    functionReturnValue = "ECONA_FILE_CONTENT_NOT_FOUND: Specified file content does not found (e.g. unknown file section or stored position)";
                    break;
                case PCCSErrors.ECONA_FILE_OLD_FORMAT:
                    functionReturnValue = "ECONA_FILE_OLD_FORMAT: Specified file content supports old engine";
                    break;
                case PCCSErrors.ECONA_FILE_INVALID_DATA:
                    functionReturnValue = "ECONA_FILE_INVALID_DATA: Specified file data is invalid";
                    break;

                // File System errors for folder functions:
                case PCCSErrors.ECONA_INVALID_DATA_DEVICE:
                    functionReturnValue = "ECONA_INVALID_DATA_DEVICE: Device's folder contains invalid data.";
                    break;
                case PCCSErrors.ECONA_CURRENT_FOLDER_NOT_FOUND:
                    functionReturnValue = "ECONA_CURRENT_FOLDER_NOT_FOUND: Current folder is invalid in device (e.g MMC card removed).";
                    break;
                case PCCSErrors.ECONA_FOLDER_PATH_TOO_LONG:
                    functionReturnValue = "ECONA_FOLDER_PATH_TOO_LONG: Maximum folder path length is 255 characters.";
                    break;
                case PCCSErrors.ECONA_FOLDER_NAME_INVALID:
                    functionReturnValue = "ECONA_FOLDER_NAME_INVALID: Folder name includes invalid characters in Device or PC.";
                    break;
                case PCCSErrors.ECONA_FOLDER_ALREADY_EXIST:
                    functionReturnValue = "ECONA_FOLDER_ALREADY_EXIST: Folder already exists in target folder.";
                    break;
                case PCCSErrors.ECONA_FOLDER_NOT_FOUND:
                    functionReturnValue = "ECONA_FOLDER_NOT_FOUND: Folder does not exist in target folder.";
                    break;
                case PCCSErrors.ECONA_FOLDER_NO_PERMISSION:
                    functionReturnValue = "ECONA_FOLDER_NO_PERMISSION: Not allowed to perform required operation to folder in Device.";
                    break;
                case PCCSErrors.ECONA_FOLDER_NOT_EMPTY:
                    functionReturnValue = "ECONA_FOLDER_NOT_EMPTY: Not allowed to perform required operation because folder is not empty.";
                    break;
                case PCCSErrors.ECONA_FOLDER_NO_PERMISSION_ON_PC:
                    functionReturnValue = "ECONA_FOLDER_NO_PERMISSION_ON_PC: Not allowed to perform required operation to folder in PC.";
                    break;

                // Application installation error:
                case PCCSErrors.ECONA_DEVICE_INSTALLER_BUSY:
                    functionReturnValue = "ECONA_DEVICE_INSTALLER_BUSY: Cannot start device's installer.";
                    break;

                // Syncronization specific error codes:
                case PCCSErrors.ECONA_UI_NOT_IDLE_DEVICE:
                    functionReturnValue = "ECONA_UI_NOT_IDLE_DEVICE: Device rejects the operation. Maybe device's UI is not in idle state.";
                    break;
                case PCCSErrors.ECONA_SYNC_CLIENT_BUSY_DEVICE:
                    functionReturnValue = "ECONA_SYNC_CLIENT_BUSY_DEVICE: Device's SA sync client is busy.";
                    break;
                case PCCSErrors.ECONA_UNAUTHORIZED_DEVICE:
                    functionReturnValue = "ECONA_UNAUTHORIZED_DEVICE: Device rejects the operation. No permission.";
                    break;
                case PCCSErrors.ECONA_DATABASE_LOCKED_DEVICE:
                    functionReturnValue = "ECONA_DATABASE_LOCKED_DEVICE: Device rejects the operation. Device is locked.";
                    break;
                case PCCSErrors.ECONA_SETTINGS_NOT_OK_DEVICE:
                    functionReturnValue = "ECONA_SETTINGS_NOT_OK_DEVICE: Device rejects the operation. Maybe settings in Sync profile are wrong on Device.";
                    break;
                case PCCSErrors.ECONA_SYNC_ITEM_TOO_BIG:
                    functionReturnValue = "ECONA_SYNC_ITEM_TOO_BIG: Device rejected the operation";
                    break;
                case PCCSErrors.ECONA_SYNC_ITEM_REJECT:
                    functionReturnValue = "ECONA_SYNC_ITEM_REJECT: Device rejected the operation";
                    break;
                case PCCSErrors.ECONA_SYNC_INSTALL_PLUGIN_FIRST:
                    functionReturnValue = "ECONA_SYNC_INSTALL_PLUGIN_FIRST: Device rejected the operation";
                    break;

                // Versit conversion specific error codes :			
                case PCCSErrors.ECONA_VERSIT_INVALID_PARAM:
                    functionReturnValue = "ECONA_VERSIT_INVALID_PARAM: Invalid parameters passed to versit converter.";
                    break;
                case PCCSErrors.ECONA_VERSIT_UNKNOWN_TYPE:
                    functionReturnValue = "ECONA_VERSIT_UNKNOWN_TYPE: Failed, trying to convert versit formats not supported in VersitConverter.";
                    break;
                case PCCSErrors.ECONA_VERSIT_INVALID_VERSIT_OBJECT:
                    functionReturnValue = "ECONA_VERSIT_INVALID_VERSIT_OBJECT: Failed, validation of versit data not passed, contains invalid data.";
                    break;

                // Database specific error codes:
                case PCCSErrors.ECONA_DB_TRANSACTION_ALREADY_STARTED:
                    functionReturnValue = "Another transaction is already in progress";
                    break;
                case PCCSErrors.ECONA_DB_TRANSACTION_FAILED:
                    functionReturnValue = "Some of operations within a transaction failed and transaction was rolled back";
                    break;

                // Backup specific error codes:
                case PCCSErrors.ECONA_DEVICE_BATTERY_LEVEL_TOO_LOW:
                    functionReturnValue = "Failed, device rejects the restore operation. Device's battery level is low.";
                    break;
                case PCCSErrors.ECONA_DEVICE_BUSY:
                    functionReturnValue = "Failed, device rejects the backup/restore operation. Device's backup server busy.";
                    break;

                default:
                    functionReturnValue = "Undefined error code"; // shouldn't occur
                    break;
            }
            return functionReturnValue;
        }

        //===================================================================
        // ErrorMessageDlg --  Show an errormessage
        //
        //
        //===================================================================
        public static void ShowErrorMessage(string strError, int errorCode)
        {
            string strMessage = strError + "\n" + "\n" + string.Format("Error: {0:x2}", errorCode) + "\n" + CONAError2String(errorCode);
            System.Windows.Forms.MessageBox.Show(strMessage);
        }
    }
}