conaapplicationinstallation.cs

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

        // ECONA_FILE_NAME_TOO_LONG
        // ECONA_FILE_TYPE_NOT_SUPPORTED
        // ECONA_FILE_NOT_FOUND
        // ECONA_FILE_ALREADY_EXIST
        // ECONA_FILE_NO_PERMISSION
        // ECONA_FILE_NO_PERMISSION_ON_PC
        // ECONA_FILE_BUSY
        // ECONA_DEVICE_INSTALLER_BUSY
        // ECONA_CANCELLED
        // ECONA_FAILED_TIMEOUT
        // ECONA_FILE_TYPE_NOT_SUPPORTED
        // ECONA_NOT_SUPPORTED_DEVICE
        // ECONA_UNKNOWN_ERROR_DEVICE
        // ECONA_NOT_INITIALIZED
        // ECONA_NOT_SUPPORTED_MANUFACTURER
        // ECONA_UNKNOWN_ERROR

        public static extern int CONAInstallJavaApplication(
            int hFSHandle,
            int iApplicationType,
            ref CONAPI_APPLICATION_JAVA pApplicationStruct,
            int iOptions,
            [MarshalAs(UnmanagedType.LPWStr)] string pstrSourcePath,
            [MarshalAs(UnmanagedType.LPWStr)] string pstrTargetPath
            );

        [DllImport("ConnAPI", EntryPoint = "CONAInstallApplication", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true)]
        public static extern int CONAInstallSymbianApplication(
            int hFSHandle,
            int iApplicationType,
            ref CONAPI_APPLICATION_SIS pApplicationStruct,
            int iOptions,
            string pstrSourcePath,
            string pstrTargetPath
            );

        [DllImport("ConnAPI", EntryPoint = "CONAInstallApplication", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true)]
        public static extern int CONAInstallTheme(
            int hFSHandle,
            int iApplicationType,
            ref CONAPI_APPLICATION_FILE pApplicationStruct,
            int iOptions,
            [MarshalAs(UnmanagedType.LPWStr)] string pstrSourcePath,
            [MarshalAs(UnmanagedType.LPWStr)] string pstrTargetPath
            );

        [DllImport("ConnAPI", EntryPoint = "CONAListApplications", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true)]
        //=========================================================
        //
        //=========================================================
        // CONAListApplications 
        //
        // Description:
        //	CONAListApplications function list all installed applications on 
        //	the device. FS's CONACancel function can be used to cancel 
        //	this function. 
        //	NOTE 1: Only new Series 60 3nd edition devices are supported at the moment. 
        //	        If target device is not supported function fails with error code ECONA_NOT_SUPPORTED_DEVICE.
        //	NOTE 2: If target device is supported, CONAGetDeviceInfo function returns value CONAPI_FS_LIST_APPLICATIONS.
        //	
        //
        //
        // Parameters:
        //	hFSHandle			[in] File System handle
        //	dwOptions			[in] Options: 
        //			CONA_LIST_ALL_APPICATIONS: List all installed applications. This value must be used.
        //	pdwNumberOfAppInfoStructures [out] Number of CONAPI_APPLICATION_INFO structures. 
        //	ppAppInfoStructures			 [out] Pointer to CONAPI_APPLICATION_INFO structure(s). 
        //
        // Return values:
        // CONA_OK
        // ECONA_INVALID_HANDLE
        // ECONA_INVALID_PARAMETER
        // ECONA_INVALID_POINTER
        // ECONA_CONNECTION_BUSY
        // ECONA_CONNECTION_LOST
        // ECONA_INVALID_DATA_DEVICE
        // ECONA_MEMORY_FULL
        // ECONA_CANCELLED
        // ECONA_FAILED_TIMEOUT
        // ECONA_NOT_SUPPORTED_DEVICE
        // ECONA_UNKNOWN_ERROR_DEVICE
        // ECONA_NOT_INITIALIZED
        // ECONA_NOT_SUPPORTED_MANUFACTURER
        // ECONA_UNKNOWN_ERROR
        //
        public static extern int CONAListApplications(
            int hFSHandle,
            int iOptions,
            ref int NumberOfAppInfoStructures,
            ref System.IntPtr ppAppInfoStruct
            );

        [DllImport("ConnAPI", EntryPoint = "CONAUninstallApplication", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true)]
        //=========================================================
        //
        //=========================================================
        // CONAUninstallApplication 
        //
        // Description:
        //	CONAUninstallApplication function uninstalls application
        //	from device. FS's CONACancel function can be used to cancel 
        //	this function. 
        //	NOTE 1: Only new Series 60 3nd edition devices are supported at the moment. 
        //	        If target device is not supported, function fails with error code 
        //			ECONA_NOT_SUPPORTED_DEVICE. And if target device is supported, 
        //			CONAGetDeviceInfo function returns value CONAPI_FS_UNINSTALL_APPLICATIONS.
        //	
        // Parameters:
        //	hFSHandle			[in] File System handle
        //	dwOptions			[in] Options: 
        //		CONA_DEFAULT_UNINSTALLATION: Default uninstallation, the user may have to finish the uninstallation from device side.
        //		If user action is needed, a maximum waiting time is 15 minutes for this user action. Whole this waiting time ConnAPI 
        //		sends File System callback nofications and dwState value is CONA_OK_BUT_USER_ACTION_NEEDED.
        //		CONA_SILENT_UNINSTALLATION: Silent uninstallation, no need user action from device side.
        //	pstrName			[in] Target application Name, see CONAPI_APPLICATION_INFO structure. This value must be set.
        //	pstrUID				[in] Target application UID, see CONAPI_APPLICATION_INFO structure. This value must be set.
        //
        // Return values:
        // CONA_OK
        // CONA_OK_BUT_USER_ACTION_NEEDED
        // ECONA_INVALID_HANDLE
        // ECONA_INVALID_PARAMETER
        // ECONA_INVALID_POINTER
        // ECONA_CONNECTION_BUSY
        // ECONA_CONNECTION_LOST
        // ECONA_INVALID_DATA_DEVICE
        // ECONA_FILE_NO_PERMISSION
        // ECONA_FILE_NOT_FOUND
        // ECONA_FILE_BUSY
        // ECONA_MEMORY_FULL
        // ECONA_CANCELLED
        // ECONA_FAILED_TIMEOUT
        // ECONA_NOT_SUPPORTED_DEVICE
        // ECONA_UNKNOWN_ERROR_DEVICE
        // ECONA_NOT_INITIALIZED
        // ECONA_NOT_SUPPORTED_MANUFACTURER
        // ECONA_UNKNOWN_ERROR
        //
        public static extern int CONAUninstallApplication(
            int hFSHandle,
            int iOptions,
            [MarshalAs(UnmanagedType.LPWStr)] string pstrAppName,
            [MarshalAs(UnmanagedType.LPWStr)] string pstrAppUID
            );

        [DllImport("ConnAPI", EntryPoint = "CONAFreeApplicationInfoStructures", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true)]
        //=========================================================

        //=========================================================
        // CONAFreeApplicationInfoStructures
        //
        // Description:
        //	CONAFreeApplicationInfoStructures releases the CONAPI_APPLICATION_INFO structs, 
        //	which CONAListApplications function is allocated.
        //
        // Parameters:
        //	dwNumberOfAppInfoStructures	[in] Number of CONAPI_APPLICATION_INFO structures.
        //	ppAppInfoStructures	[in] Pointer to CONAPI_APPLICATION_INFO structure(s).
        //
        // Return values:
        //	CONA_OK
        //	ECONA_INVALID_POINTER
        //	ECONA_INVALID_PARAMETER
        //	ECONA_UNKNOWN_ERROR
        //
        public static extern int CONAFreeApplicationInfoStructures(
            int iNumberOfAppInfoStructures,
            ref System.IntPtr ppAppInfoStruct
            );
    }
}