fsapidefinitions.h

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

		//
		//	NOTE: Connectivity API-user MUST NOT free data block buffer in the notification.
		//
		// Parameters:
		//	dwFSFunction				[in]		Ongoing function (CONAReadFileInBlocksNtf or CONAWriteFileInBlocksNtf)
		//	pdwState					[in,out]	Pointer to function state. Used to inform when all file data is sent/received.
		//	dwSizeOfFileDataBlockBuffer	[in]		The size of file data block buffer.
		//	pdwFileDataBlockLenght		[in, out]	CONAReadFileInBlocks:	In: Actual file data lenght in buffer. 
		//											CONAWriteFileInBlocks:	Out: Actual file data length in buffer.
		//	pFileDataBlock				[in,out]	Pointer to file data block buffer.
		//		
		// Return values
		// The Connectivity API-user must return the CONA_OK value. If the callback 
		// function returns the error code ECONA_CANCELLED to the Connectivity API, 
		// the function will be cancelled with the error code ECONA_CANCELLED.
		//
		// Type definition: 
		class IFSAPIBlockNotify
		{
		public:
			virtual DWORD OnFSOperationBlockData(	DWORD dwFSFunction,
													DWORD *pdwState,
													const DWORD dwSizeOfFileDataBlockBuffer,
													DWORD *pdwFileDataBlockLenght,
													unsigned char* pFileDataBlock) = 0;
		};
		// ----------------------------------------------------
	#endif
	// ----------------------------------------------------

	// ----------------------------------------------------
	// FileOperationCallbackFunction function:
	//
	// Callback function prototype:
	//	DWORD CALLBACK FileOperationCallbackFunction(
	//							   DWORD dwFSFunction, 
	//							   DWORD dwState,
	//							   DWORD dwTransferredBytes,
	//							   DWORD dwAllBytes);
	//
		typedef DWORD (CALLBACK *PFN_CONA_FS_CALLBACK)(
									DWORD dwFSFunction,
									DWORD dwState,
									DWORD dwTransferredBytes,
									DWORD dwAllBytes );
	// ----------------------------------------------------

	// ----------------------------------------------------
	// CONAGetFolderInfoCallbackFunction function:
	//
	// Callback function prototype:
	//	DWORD CALLBACK CONAGetFolderInfoCallbackFunction(
	//							   LPCONAPI_FOLDER_CONTENT pFolderContent);
	//
		typedef DWORD (CALLBACK *PFN_CONA_FS_FOLDERINFO_CALLBACK)(
										LPCONAPI_FOLDER_INFO2 pFolderInfo);
	// ----------------------------------------------------

	// ----------------------------------------------------
	// CONABlockDataCallbackFunction function:
	//
	// Callback function prototype:
	//	DWORD CALLBACK CONABlockDataCallbackFunction(
	//							   DWORD dwFSFunction,
	//							   DWORD *pdwState,
	//							   const DWORD dwSizeOfFileDataBlockBuffer,
	//							   DWORD *pdwFileDataBlockLenght,
	//							   unsigned char* pFileDataBlock);
	//
	// Description
	//	See IFSAPIBlockNotify interface description for more information about parameters.
	//
		typedef DWORD (CALLBACK *PFN_CONA_FS_BLOCKDATA_CALLBACK)(
									DWORD dwFSFunction,
									DWORD *pdwState,
									const DWORD dwSizeOfFileDataBlockBuffer,
									DWORD *pdwFileDataBlockLenght,
									unsigned char* pFileDataBlock);
	// ----------------------------------------------------

	// FSFunction values:
	#define CONARefreshDeviceMemoryValuesNtf	0x00000001
	#define CONASetCurrentFolderNtf				0x00000002
	#define CONAFindBeginNtf					0x00000004
	#define CONACreateFolderNtf					0x00000008
	#define CONADeleteFolderNtf					0x00000010
	#define CONARenameFolderNtf					0x00000020
	#define CONAGetFileInfoNtf					0x00000040
	#define CONADeleteFileNtf					0x00000080
	#define CONAMoveFileNtf						0x00000100
	#define CONACopyFileNtf						0x00000200
	#define CONARenameFileNtf					0x00000400
	#define CONAReadFileNtf						0x00000800
	#define CONAWriteFileNtf					0x00001000
	#define CONAConnectionLostNtf 				0x00002000
	#define CONAInstallApplicationNtf			0x00004000
	#define CONAConvertFileNtf					0x00008000
	#define CONAGetFolderInfoNtf				0x00010000
	#define CONAListApplicationNtf				0x00020000
	#define CONAUninstallApplicationNtf			0x00040000
	#define CONAReadFileInBlocksNtf				0x00080000
	#define CONAWriteFileInBlocksNtf			0x00100000
	#define CONAMoveFolderNtf					0x00200000
	#define CONACopyFolderNtf					0x00400000
	#define CONAGetFileMetadataNtf				0x00800000
		
	// The next function do not send notifications:
	//	CONAOpenFS					
	//	CONACloseFS				
	//	CONARegisterFSNotifyCallback
	//	CONAGetMemoryTypes 			
	//	CONAGetMemoryValues			
	//	CONAGetCurrentFolder	
	//	CONAFindNextFolder		
	//	CONAFindNextFile		
	//	CONAFindEnd					
	//	CONACancel				

	// Possible error codes value in dwStatus parameter when 
	// FSFunction value is CONAConnectionLost:
	//	ECONA_CONNECTION_LOST
	//  ECONA_CONNECTION_REMOVED
	//  ECONA_CONNECTION_FAILED
	//  ECONA_SUSPEND
	// ----------------------------------------------------

//=========================================================

/////////////////////////////////////////////////////////////////////
// File System API Application Installation definitions
/////////////////////////////////////////////////////////////////////

	//The next define values used to define which type of struct is used:
	#define CONA_APPLICATION_TYPE_SIS		0x00000001 // Use when struct type is CONAPI_APPLICATION_SIS
	#define CONA_APPLICATION_TYPE_JAVA		0x00000002 // Use when struct type is CONAPI_APPLICATION_JAVA
	#define CONA_APPLICATION_TYPE_THEMES	0x00000004 // Use when struct type is CONAPI_APPLICATION_THEMES
	#define CONA_APPLICATION_TYPE_UNKNOWN	0x00000008 // Use only in CONAPI_APPLICATION_INFO struct, unknown application type.
	#define CONA_DEFAULT_UNINSTALLATION		0x00000100 // Default uninstallation, used with CONAUninstallApplication function.
	#define CONA_SILENT_UNINSTALLATION		0x00000200 // Silent uninstallation, used with CONAUninstallApplication function.
	#define CONA_LIST_ALL_APPICATIONS		0x00001000 // List all installed applications, used with CONAListApplications function
	#define CONA_LIST_JAVA_APPICATIONS		0x00002000 // List all installed java applications, used with CONAListApplications function
	#define CONA_LIST_THEMES_APPICATIONS	0x00004000 // List all installed themes, used with CONAListApplications function

	//The struct for sis applications
	typedef struct
	{
		WCHAR*	pstrFileNameSis; // sis application File name, must be set.
								 // The value can also include the file path in PC.
	} CONAPI_APPLICATION_SIS;

	//The struct for java applications
	typedef struct
	{
		WCHAR*	pstrFileNameJad;	// File name of the jad file. The value can also include the file path in PC. 
									// If jad file is not available, the value must be NULL.
		WCHAR*	pstrFileNameJar;	// File name of the jar file, must be set. 
									// The value can also include the file path in PC. 
	} CONAPI_APPLICATION_JAVA;

	//The struct for themes file
	typedef struct
	{
		WCHAR*	pstrFileName;		// File name of the nth file, must be set
									// The value can also include the file path in PC.
		DWORD	dwOptions;			// Reserved for future use, the value must be 0.
	} CONAPI_APPLICATION_FILE;

	//The struct for application info, used with CONAListApplications function
	typedef struct
	{
		DWORD   dwSize;				// size of struct in bytes.
		WCHAR*	pstrName;			// Application name. Always exist.
		WCHAR*	pstrDescription;	// Application description. If not available, pointer is NULL.
		WCHAR*  pstrVendor;			// Application vendor. If not available, pointer is NULL.
		WCHAR*	pstrVersion;		// Application version. If not available, pointer is NULL.
		WCHAR*	pstrParentAppNam;	// Parent application name. This is available if application is augmentation 
									// for some other application. 
		DWORD	dwApplicationSize;	// Application size in bytes. If not available, value is -1 (0xFFFFFFFF).
		DWORD	dwApplicationType;	// Application type possible values:
									//		CONA_APPLICATION_TYPE_SIS		:	Sis application
									//		CONA_APPLICATION_TYPE_JAVA		:	Java application
									//		CONA_APPLICATION_TYPE_THEMES	:	Themes application	
									//		CONA_APPLICATION_TYPE_UNKNOWN	:	Application type is not available
		WCHAR*	pstrUID;			// Application UID string, used with CONAUninstallApplication function.
		DWORD   dwOptions;			// Reserved for future use. Value is zero.
		WCHAR*  pstrValue;			// Reserved for future use. Pointer is NULL.
	} CONAPI_APPLICATION_INFO;
	
/////////////////////////////////////////////////////////////////////
// File System API File Conversion definitions
/////////////////////////////////////////////////////////////////////

	//	The CONAPI_CONVERT_FILE_TYPE structure
	typedef struct
	{
		WCHAR*	pstrFileExtension;			// Input file extension, which can be converted on device. E.g "ewd"
		WCHAR*	pstrFileMIMEType;			// Input file MIME type, which can be converted on device. E.g "x-epoc/x-app268450404"
		WCHAR*	pstrOutputFileExtension;	// Output file extension. E.g "doc"
	} CONAPI_CONVERT_FILE_TYPE;

#endif