conaapplicationinstallation.vb

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

    ' ECONA_MEMORY_FULL
    ' ECONA_CURRENT_FOLDER_NOT_FOUND
    ' ECONA_FOLDER_PATH_TOO_LONG
    ' ECONA_FOLDER_NOT_FOUND
    ' ECONA_FOLDER_NO_PERMISSION_ON_PC
    ' ECONA_FILE_TOO_BIG_DEVICE
    ' ECONA_FILE_NAME_INVALID
    ' 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 Declare Function CONAInstallJavaApplication Lib "ConnAPI" Alias "CONAInstallApplication" (ByVal hFSHandle As Integer, ByVal iApplicationType As Integer, ByRef pApplicationStruct As CONAPI_APPLICATION_JAVA, ByVal iOptions As Integer, <MarshalAs(UnmanagedType.LPWStr)> ByVal pstrSourcePath As String, <MarshalAs(UnmanagedType.LPWStr)> ByVal pstrTargetPath As String) As Integer
    Public Declare Function CONAInstallSymbianApplication Lib "ConnAPI" Alias "CONAInstallApplication" (ByVal hFSHandle As Integer, ByVal iApplicationType As Integer, ByRef pApplicationStruct As CONAPI_APPLICATION_SIS, ByVal iOptions As Integer, <MarshalAs(UnmanagedType.LPWStr)> ByVal pstrSourcePath As String, <MarshalAs(UnmanagedType.LPWStr)> ByVal pstrTargetPath As String) As Integer
    Public Declare Function CONAInstallTheme Lib "ConnAPI" Alias "CONAInstallApplication" (ByVal hFSHandle As Integer, ByVal iApplicationType As Integer, ByRef pApplicationStruct As CONAPI_APPLICATION_FILE, ByVal iOptions As Integer, <MarshalAs(UnmanagedType.LPWStr)> ByVal pstrSourcePath As String, <MarshalAs(UnmanagedType.LPWStr)> ByVal pstrTargetPath As String) As Integer

    '=========================================================

    
    '=========================================================
    ' 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 Declare Function CONAListApplications Lib "ConnAPI" Alias "CONAListApplications" (ByVal hFSHandle As Integer, ByVal iOptions As Integer, ByRef NumberOfAppInfoStructures As Integer, ByRef ppAppInfoStruct As IntPtr) As Integer

    '=========================================================
    '
    '=========================================================
    ' 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 Declare Function CONAUninstallApplication Lib "ConnAPI" Alias "CONAUninstallApplication" (ByVal hFSHandle As Integer, ByVal iOptions As Integer, <MarshalAs(UnmanagedType.LPWStr)> ByVal pstrAppName As String, <MarshalAs(UnmanagedType.LPWStr)> ByVal pstrAppUID As String) As Integer

    '=========================================================

    '=========================================================
    ' 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 Declare Function CONAFreeApplicationInfoStructures Lib "ConnAPI" Alias "CONAFreeApplicationInfoStructures" (ByVal iNumberOfAppInfoStructures As Integer, ByRef ppAppInfoStruct As IntPtr) As Integer
End Module