當前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

Rapi

發布時間：2023/11/30 编程问答 44 豆豆

生活随笔收集整理的這篇文章主要介紹了 Rapi 小編覺得挺不錯的,現在分享給大家,幫大家做個參考.

本頁內容

●	引言
●	SMARTPHONE SDK API 庫
●	管理設備中的目錄文件
●	取系統信息
●	遠程操作電話和短信功能

??? Windows Mobile日益成熟，開發者隊伍也越來越壯大。作為一個10年的計算機熱愛者和程序員，我也經受不住新技術的誘惑，倒騰起Mobile這個玩具。Mobile和Windows的血緣關系決定了它在Windows程序員中的受歡迎程度，在網絡上隨便搜索一下，關于Mobile應用、開發的文章數不勝數。可是對于計劃開發一款全能的Desktop<=>Device同步管理程序的我來說，卻發現資源少得可憐——僅僅在MSDN和兩個國外的Developer網站上發現了一點資料?，F在我仍然在搜索學習中，在這里把我迄今掌握的一點心得寫出來，希望能起到拋磚引玉的功效。另請各位高手指正。

??? Mobile的開發資源很繁雜，很多人常常弄不清究竟要安裝哪些工具才能搭建出合適的開發環境。但是我相信Microsoft SMARTPHONE 2003 SDK和Microsoft POCKETPC 2003 SDK是所有的人都知道的，它們分別為SmartPhone和PocketPC提供了必不可少的支持。兄弟我至今沒有做出什么成績，囊中羞澀，好容易攢了臺SmartPhone，今天就已Microsoft SMARTPHONE 2003 SDK為例吧。

??? SMARTPHONE SDK包含了大量的API，列表如下（選自SDK文檔，本人翻譯）：

Smartphone APIDescription

ActiveSync	創建移動應用程序安裝和配置，同步服務模塊，過濾器和協助訪問ActiveSync服務的應用。
Bluetooth API	創建支持藍牙設備的Mobile應用程序，比如耳機，打印機和其他移動設備。
CE Messaging (CEMAPI)	創建messaging applications
Configuration Service Providers	創建可配置各種CSPs（Configuration Service Providers）的應用
Connection Manager	創建可自動管理移動設備網絡連接的應用
Control API	在你的移動應用程序中使用Smartphone控件
Device Management API	創建可遠程訪問移動設備配置管理的應用程序
Game API (GAPI)	創建高性能的實時游戲
Home Screen API	創建用戶界面插件
HTML Control	創建可顯示HTML文本和嵌入圖片，解析XML和綁定URL到別名的應用程序
MIDI	創建可播放MIDI文件的應用程序
Object Exchange (OBEX)	創建對象交換應用，允許移動設備自由的通過無線交換數據
Pocket Outlook Object Model (POOM) API	創建可操作收件箱部件（聯系人，日歷和任務）的移動應用程序
Projects Control	創建可以和Projects Control交互的應用
Remote API (RAPI)	創建可以同步或控制移動設備的桌面應用程序
Speech Recognizer	為應用程序增加語音識別功能（比如語音撥號）
Telephony	創建支持電話和短信的應用程序
User Interface	管理輸入面板，增加用戶界面元素到你的移動應用程序
Vibrate API	為你的移動應用程序增加震動特性
Voice Recorder Control	創建移動數字錄音程序
Windows User Interface Controls	創建將移動擴展合并到標準Microsoft? Windows? CE用戶界面控件的應用

??? 要創建Desktop<=>Device的桌面同步管理程序，主要就依靠SDK API中的Remote API（RAPI）。RAPI 庫由一組函數組成，這些函數可用于通過桌面應用程序管理設備，包括設備的目錄文件、設備的注冊表和系統信息。廢話不多說，我們先來看看如何管理設備中的目錄文件。

??? RAPI提供了一組文件管理的方法（不完全列表，詳見SDK文檔。選自SDK文檔，本人翻譯）：

FunctionDescription

CeCopyFile	復制文件
CeCreateDirectory	創建目錄
CeCreateFile	創建，打開文件、管道、通訊資源、磁盤設備或者控制臺。返回一個句柄用來訪問對象。
CeDeleteFile	刪除文件
CeFindAllFiles	從指定的Windows CE目錄中獲取所有文件和目錄的信息，并且復制到一個包含CE_FIND_DATA結構的數組中
CeFindFirstFile	在目錄中查找匹配給定文件名的一個文件
CeFindClose	關閉指定的查找句柄，CeFindFirstFile和CeFindNextFile 函數用這個句柄查找文件
CeFindNextFile	從上一次訪問的CeFindFirstFile繼續查找文件
CeGetFileAttributes	返回指定文件或目錄的屬性
CeGetFileSize	獲取指定文件的字節大小
CeGetFileTime	獲取文件創建日期時間，最后訪問日期時間和最后修改日期時間
CeMoveFile	移動（重命名）一個文件或者目錄
CeReadFile	從文件指針處讀取文件數據
CeWriteFile	從文件指針處寫入文件數據

??? 首先要說明的是，任何RAPI操作都需要首先初始化與設備的連接：

FunctionDescription

CeRapiInit (RAPI)

創建Windows CE remote application-programming interface (RAPI).

[C#.NET]
　 using System;using System.Runtime.InteropServices; public class RAPI{ public void RapiInit() { int ret = CeRapiInit(); if( ret != 0) { // 連接失敗，獲取失敗代碼 int e = CeRapiGetError(); // 拋出異常 Marshal.ThrowExceptionForHR(ret); } // 連接成功 // To Do } [DllImport("rapi.dll", CharSet=CharSet.Unicode)] internal static extern int CeRapiGetError(); [DllImport("rapi.dll", CharSet=CharSet.Unicode)] internal static extern int CeRapiInit();}

??? 連接建立后，就可以進行文件操作了?？匆粋€將文件復制到設備的例子：

[C#.NET] using System;using System.Runtime.InteropServices;using System.IO; public class RAPI{ private const uint GENERIC_WRITE = 0x40000000; // 設置讀寫權限 private const short CREATE_NEW = 1; // 創建新文件 private const short FILE_ATTRIBUTE_NORMAL = 0x80; // 設置文件屬性 private const short INVALID_HANDLE_VALUE = -1; // 錯誤句柄 IntPtr remoteFile = IntPtr.Zero; String LocalFileName = @"c:/test.txt"; // 本地計算機文件名 String RemoteFileName = @"/My Documents/test.txt"; // 遠程設備文件名 byte[] buffer = new byte[0x1000]; // 傳輸緩沖區定義為4k FileStream localFile; int bytesread = 0; int byteswritten = 0; int filepos = 0; public RapiFile() { // 創建遠程文件 remoteFile = CeCreateFile(RemoteFileName, GENERIC_WRITE, 0, 0, CREATE_NEW, FILE_ATTRIBUTE_NORMAL, 0); // 檢查文件是否創建成功 if ((int)remoteFile == INVALID_HANDLE_VALUE) { throw new Exception("Could not create remote file"); } // 打開本地文件 localFile = new FileStream(LocalFileName, FileMode.Open); // 讀取4K字節 bytesread = localFile.Read(buffer, filepos, buffer.Length); while(bytesread > 0) { // 移動文件指針到已讀取的位置 filepos += bytesread; // 寫緩沖區數據到遠程設備文件 if(! Convert.ToBoolean(CeWriteFile(remoteFile, buffer, bytesread, ref byteswritten, 0))) { // 檢查是否成功，不成功關閉文件句柄，拋出異常 CeCloseHandle(remoteFile); throw new Exception("Could not write to remote file"); } try { // 重新填充本地緩沖區 bytesread = localFile.Read(buffer, 0, buffer.Length); } catch(Exception) { bytesread = 0; } } // 關閉本地文件 localFile.Close(); // 關閉遠程文件 CeCloseHandle(remoteFile); } // 聲明要引用的API [DllImport("rapi.dll", CharSet=CharSet.Unicode)] internal static extern int CeCloseHandle(IntPtr hObject); [DllImport("rapi.dll", CharSet=CharSet.Unicode)] internal static extern int CeWriteFile(IntPtr hFile, byte[] lpBuffer, int nNumberOfbytesToWrite, ref int lpNumberOfbytesWritten, int lpOverlapped); [DllImport("rapi.dll", CharSet=CharSet.Unicode, SetLastError=true)] internal static extern IntPtr CeCreateFile( string lpFileName, uint dwDesiredAccess, int dwShareMode, int lpSecurityAttributes, int dwCreationDisposition, int dwFlagsAndAttributes, int hTemplateFile);}

??? 操作完畢后在合適的時候需要斷開RAPI連接，使用如下函數（選自SDK文檔，本人翻譯）：

FunctionDescription

CeRapiUninit (RAPI)

銷毀Windows CE remote application-programming interface (RAPI).

[C#.NET] using System;using System.Runtime.InteropServices;public class RAPIUninit
{ public RAPIUninit() { CeRapiUninit(); } // 聲明要引用的API [DllImport("rapi.dll", CharSet=CharSet.Unicode)] internal static extern int CeRapiUninit();}

??? 文件操作的函數有很多，基本思路都是一樣的，在這里就不一一舉例了。請注意文件句柄使用以后一定要釋放。

??? 我們再看一個取系統信息的例子，RAPI提供了一些取系統信息的函數（選自SDK文檔，本人翻譯）：

FunctionDescription

CeGetSystemInfo	返回當前系統信息
CeGetSystemMetrics	獲取Windows元素的尺寸和系統設置
CeGetVersionEx	獲取當前運行的操作系統版本的擴展信息
CeGetSystemPowerStatusEx	獲取電池狀態
CeGlobalMemoryStatus	獲取系統物理內存和虛擬內存信息
CeGetStoreInformation	獲取存儲器信息并填入STORE_INFORMATION結構

[C#.net] public class RAPI{ SYSTEM_INFO si; // 系統信息 OSVERSIONINFO versionInfo; // 版本信息 SYSTEM_POWER_STATUS_EX PowerStatus; // 電源信息 MEMORYSTATUS ms; // 內存信息 String info; public void systemInfo() { // 檢索系統信息 try { CeGetSystemInfo(out si); } catch(Exception) { throw new Exception("Error retrieving system info."); } // 檢索設備操作系統版本號。 bool b; versionInfo.dwOSVersionInfoSize = Marshal.SizeOf(typeof(OSVERSIONINFO)); // 設置為結構大小 b = CeGetVersionEx(out versionInfo); if(!b) { throw new Exception("Error retrieving version information."); } // 檢索設備電源狀態 try { CeGetSystemPowerStatusEx(out PowerStatus, true); // true 表示讀取最新的電源信息,否則將從緩存中獲得 } catch(Exception) { throw new Exception("Error retrieving system power status."); } // 檢索設備內存狀態 CeGlobalMemoryStatus( out ms ); // 設置檢索信息的格式。 info = "The connected device has an "; switch (si.wProcessorArchitecture) { case ProcessorArchitecture.Intel: info += "Intel processor./n"; break; case ProcessorArchitecture.MIPS: info += "MIPS processor./n"; break; case ProcessorArchitecture.ARM: info += "ARM processor./n"; break; default: info = "unknown processor type./n"; break; } info += "OS version: " + versionInfo.dwMajorVersion + "." + versionInfo.dwMinorVersion + "." + versionInfo.dwBuildNumber + "/n"; if (PowerStatus.ACLineStatus == 1) { info += "On AC power:YES/n"; } else { info += "On AC power:NO /n"; } info += "Battery level: " + PowerStatus.BatteryLifePercent + "%/n"; info += "Total memory: " + String.Format("{0:###,###,###}",? ms.dwTotalPhys) + "/n"; // 顯示結果。 Console.WriteLine(info); } #region 聲明API,詳見SDK文檔 [DllImport("rapi.dll", CharSet=CharSet.Unicode, SetLastError=true)] internal static extern int CeGetSystemInfo(out SYSTEM_INFO pSI); [DllImport("rapi.dll", CharSet=CharSet.Unicode, SetLastError=true)] internal static extern bool CeGetVersionEx(out OSVERSIONINFO lpVersionInformation); [DllImport("rapi.dll", CharSet=CharSet.Unicode, SetLastError=true)] internal static extern bool CeGetSystemPowerStatusEx(out SYSTEM_POWER_STATUS_EX pStatus, bool fUpdate); [DllImport("rapi.dll", CharSet=CharSet.Unicode, SetLastError=true)] internal static extern void CeGlobalMemoryStatus(out MEMORYSTATUS msce); #endregion #region 聲明結構 /// /// 處理器架構 (CeGetSystemInfo) /// public enum ProcessorArchitecture : short { /// /// Intel /// Intel = 0, /// /// MIPS /// MIPS = 1, /// /// Alpha /// Alpha = 2, /// /// PowerPC /// PPC = 3, /// /// Hitachi SHx /// SHX = 4, /// /// ARM /// ARM = 5, /// /// IA64 /// IA64 = 6, /// /// Alpha 64 /// Alpha64 = 7, /// /// Unknown /// Unknown = -1 } /// /// 移動設備內存信息 /// [StructLayout(LayoutKind.Sequential)] public struct MEMORYSTATUS { internal uint dwLength; /// /// 當前內存占用 (%) /// public int dwMemoryLoad; /// /// 物理內存總量 /// public int dwTotalPhys; /// /// 可用物理內存 /// public int dwAvailPhys; /// /// 分頁數 /// public int dwTotalPageFile; /// /// 未分頁 /// public int dwAvailPageFile; /// /// 虛擬內存總量 /// public int dwTotalVirtual; /// /// 可用虛擬內存 /// public int dwAvailVirtual; } /// /// 移動設備電源信息 /// public struct SYSTEM_POWER_STATUS_EX { /// /// 交流電狀態 /// public byte ACLineStatus; /// /// 電池充電狀態。1 High，2 Low，4 Critical，8 Charging，128 No system battery，255 Unknown status /// public byte BatteryFlag; /// /// 電池電量剩余百分比 /// public byte BatteryLifePercent; /// /// 保留字段，設置為0 /// internal byte Reserved1; /// /// 電池電量剩余時間（秒） /// public int BatteryLifeTime; /// /// 電池充滿電的總可用時間（秒） /// public int BatteryFullLifeTime; /// /// 保留字段，設置為0 /// internal byte Reserved2; /// /// 后備電池狀態 /// public byte BackupBatteryFlag; /// /// 后備電池剩余電量百分比 /// public byte BackupBatteryLifePercent; /// /// 保留字段，設置為0 /// internal byte Reserved3; /// /// 后備電池電量剩余時間（秒） /// public int BackupBatteryLifeTime; /// /// 后備電池充滿電的總可用時間（秒） /// public int BackupBatteryFullLifeTime; } /// /// OSVERSIONINFO platform type /// public enum PlatformType : int { /// /// Win32 on Windows CE. /// VER_PLATFORM_WIN32_CE = 3 } /// /// 操作系統版本信息 /// public struct OSVERSIONINFO { internal int dwOSVersionInfoSize; /// /// 主版本信息 /// public int dwMajorVersion; /// /// 副版本信息 /// public int dwMinorVersion; /// /// 編譯信息 /// public int dwBuildNumber; /// /// 操作系統類型 /// public PlatformType dwPlatformId; } /// /// 處理器類型 (CeGetSystemInfo) /// public enum ProcessorType : int { /// /// 386 /// PROCESSOR_INTEL_386 = 386, /// /// 486 /// PROCESSOR_INTEL_486 = 486, /// /// Pentium /// PROCESSOR_INTEL_PENTIUM = 586, /// /// P2 /// PROCESSOR_INTEL_PENTIUMII = 686, /// /// IA 64 /// PROCESSOR_INTEL_IA64 = 2200, /// /// MIPS 4000 series /// PROCESSOR_MIPS_R4000??????? = 4000, /// /// Alpha 21064 /// PROCESSOR_ALPHA_21064?????? = 21064, /// /// PowerPC 403 /// PROCESSOR_PPC_403?????????? = 403, /// /// PowerPC 601 /// PROCESSOR_PPC_601?????????? = 601, /// /// PowerPC 603 /// PROCESSOR_PPC_603?????????? = 603, /// /// PowerPC 604 /// PROCESSOR_PPC_604?????????? = 604, /// /// PowerPC 620 /// PROCESSOR_PPC_620?????????? = 620, /// /// Hitachi SH3 /// PROCESSOR_HITACHI_SH3?????? = 10003, /// /// Hitachi SH3E /// PROCESSOR_HITACHI_SH3E????? = 10004, /// /// Hitachi SH4 /// PROCESSOR_HITACHI_SH4?????? = 10005, /// /// Motorola 821 /// PROCESSOR_MOTOROLA_821????? = 821, /// /// Hitachi SH3 /// PROCESSOR_SHx_SH3?????????? = 103, /// /// Hitachi SH4 /// PROCESSOR_SHx_SH4?????????? = 104, /// /// Intel StrongARM /// PROCESSOR_STRONGARM???????? = 2577, /// /// ARM720 /// PROCESSOR_ARM720??????????? = 1824, /// /// ARM820 /// PROCESSOR_ARM820??????????? = 2080, /// /// ARM920 /// PROCESSOR_ARM920??????????? = 2336, /// /// ARM 7 /// PROCESSOR_ARM_7TDMI???????? = 70001 } /// /// CeGetSystemInfo的數據結構 /// public struct SYSTEM_INFO { /// /// 處理器架構 /// public ProcessorArchitecture wProcessorArchitecture; /// /// 保留 /// internal ushort wReserved; /// /// Specifies the page size and the granularity of page protection and commitment. /// public int dwPageSize; /// /// 應用程序可訪問內存地址的最小值 ///（Pointer to the lowest memory address accessible to applications /// and dynamic-link libraries (DLLs). ） /// public int lpMinimumApplicationAddress; /// /// 應用程序可訪問內存地址的最大值（Pointer to the highest memory address /// accessible to applications and DLLs.） /// public int lpMaximumApplicationAddress; /// /// Specifies a mask representing the set of processors configured into /// the system. Bit 0 is processor 0; bit 31 is processor 31. /// public int dwActiveProcessorMask; /// /// 處理器數量（Specifies the number of processors in the system.） /// public int dwNumberOfProcessors; /// /// 處理器類型（Specifies the type of processor in the system.） /// public ProcessorType dwProcessorType; /// /// Specifies the granularity with which virtual memory is allocated. /// public int dwAllocationGranularity; /// /// Specifies the system architecture-dependent processor level. /// public short wProcessorLevel; /// /// Specifies an architecture-dependent processor revision. /// public short wProcessorRevision; } #endregion} 　

??? RAPI可以做的事情還有很多，比如取注冊表信息，提供對 Microsoft ActiveSync 底層功能的訪問，運行遠程應用程序，文件列表等等。只要仔細閱讀SDK文檔，相信都不是難事。

??? 作為Mobile設備的桌面管理程序，備份通話記錄，聯機發送短信等功能是必不可少的。在我剛發現RAPI的時候，以為和前面的例子一樣，有現成的函數可以使用。仔細研究以后才發現要復雜的多。相信這是很多朋友的希望實現的功能，所以班門弄斧，簡述如下。

??? RAPI并沒有提供通話，SIM卡和短信方面的函數，它們分別包含在SmartPhone SDK的Phone API，SIM Manager和Short Message Service中。然而包含這些API的phone.dll，cellcore.dll和sms.dll都是儲存在設備上的，在Windows上運行的程序是無法調用存儲在遠程設備上的動態連接庫的。

??? 我們仍然需要RAPI。雖然它沒有提供直接訪問通話記錄和短信方面的操作，但是它提供了一個特殊的函數：

FunctionDescription

CeRapiInvoke

使用一種通用的機制執行遠程程序

??? CeRapiInvoke的原型如下：

STDAPI_( HRESULT ) CeRapiInvoke(
??? LPCWSTR pDllPath,????????????????????? // 包含API的Dll文件完整路徑
??? LPCWSTR pFunctionName,???????? // 要調用的函數名
??? DWORD cbInput,?????????????????????????? // 函數輸入緩沖區大小
??? BYTE * pInput,?????????????????????????????? // 函數輸入緩沖區指針
??? DWORD * pcbOutput,????????????????? // 函數輸出緩沖區大小
??? BYTE ** ppOutput,??????????????????? ?? // 函數輸出緩沖區指針
??? IRAPIStream ** ppIRAPIStream,? // 指定使用阻塞模式或流模式
??? DWORD dwReserved);??????????????? // 保留

??? CeRapiInvoke將允許我們調用遠程設備中的任何API函數！不過不是直接調用，仍然需要對遠程API進行一些“包裝”。由于時間關系，我將在不久的將來為大家獻上關于CeRapiInvoke的詳細說明。

總結

以上是生活随笔為你收集整理的Rapi的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。

Rapi