Windows CE中有了RAPI以后，PC应用程序就能远程管理Windows CE设备。导出函数将处理文件系统、注册表和数据库以及用于查 询系统配置的函数。大多数RAPI是 Windows CE API函数中的副本，只有少数的函数扩展了API。

RAPI函数被列在 Windows CE API 参考中，但是将有PC应用程序来调用而不是由 Widows CE应用程序调用。在函数的名称都有前缀Ce来与他们的Window CE的副本进行区分；例如：Windows CE中的函数 GetStoreInformation将在该函数的RAPI版本中称为 CeGetStoreInformation。在Windows CE应用程序将不会调用RAPI函数。

调用RAPI函数之前，你必须调用函数 CeRapiInit或CeRapiInitEx来初始化 RAPI库。这两个函数的区别在于CeRapiInit会阻塞（等待与Windows CE设备连接成功），而 CeRapiInitEx不会等待连接成功。

HRESULT CeRapiIni(void); 
HRESULT CeRapiInitEx(RAPIINIT *pRapiInit); 
typedef struct _RAPIINIT  
{ 
    DWORD cbSize; 
    HANDLE heRapiInit; 
    STDAPI hrRapiInit; 
} RAPIINIT; 

结束所有必要的RAPI调用时，你应该调用 下面这个函数来进行清除：

这个函数很好地关闭与远程设备地RAPI通 信。如果RAPI会话没有被初始化

CeRapiUninit将返回 E_FAIL

RAPI服务包括很多预定义的RAPI函 数，这些在连接时，PC端复制 Windows CE函数。因此，正如GetStoreInformation将把对象存储哭得大小和空间返回到 Windows CE程序，CeGetStoreInformation将把关于连接的Windows CE设备的相同信息返回到基于PC的应用程序。

大多数函数都是Windows CE函数的 副本，除了CeGetPassWord和 CeRapiInvoke

下面的列表显示的是RAPI文件管理函数， 这个列表说明几乎所有可用于 Windows CE应用程序的文件函数都可以用于基于PC的程序。< /span>

设计CeFindAllFiles 是为了增强性能，只需调用它一次就能返回给定目录的所有文件，而不需要使用 CeFindFirstFile和CeFindNextFile来重复RAPI的调用。

4．3 RAPI 数据库函数

下面的列表中显示的是RAPI数据库函数。 这些函数模拟了在Windows CE中找到的扩展数据库API

几乎所有的数据库函数都有 Windows CE副本。唯一的例外的是新函数CeCreateDatabase

这些函数与它们的Windows CE副本 的工作方式一样，但是，要记住所有的字符串都是Unicode格式。

4．4 其 他的API函数< /span>

可以说Windows CE上的功能，通过 RAPI都能实现，我在这里不可能不一一列举了。

编写RAPI应用程序需要加 RAPI.h 和 RAPI.lib

[Tools]\[Options…]\[Directories]进 行设置他们的目录。< /span>

在VSS2005下的设置方法：< /span>

下面时.h文件lib的存放目录。< /span>

这个程序是从小机器上复制文件到PC的控制 台应用程序。< /span>

代码部分就不具体写出了。只说明一下流程< /span>

8． 最 后调用CeRapiUninit(); 进行清楚。< /span>

下面的这张截图就是把CE端的 “\battery.png” 复制到 PC上的“c:\test.png”文件中。

无论RAPI接口支持多少函数，总会出现一 些应用程序需要的但RAPI接口没有提供的函数。RAPI为 PC提供一种方法去调用 Windows　CE上的用户定义的函数。< /span>

你可以使用两种方法来调用用户定义的函数。 一种是“阻塞模式”，另一种是“流模式”< /span>

6．1 使 用RAPI调用自定义函数。< /span>

CeRapiInvoke将 允许我们调用远程设备中的任何API函数！不过不是直接调用，仍然需要对远程API 进行一些“包装”。

CeRapiInvoke的 原型如下：

STDAPI_( HRESULT ) CeRapiInvoke(
    LPCWSTR pDllPath,                      //  包含API的Dll文件完整路径
    LPCWSTR pFunctionName,         //  要调用的函数名
    DWORD cbInput,                           //  函数输入缓冲区大小
    BYTE * pInput,                               //  函数输入缓冲区指针
    DWORD * pcbOutput,                  //  函数输出缓冲区大小
    BYTE ** ppOutput,                       //  函数输出缓冲区指针
    IRAPIStream ** ppIRAPIStream,  //  指定使用阻塞模式或流模式
    DWORD dwReserved);                //  保留

6．2 编 写RAPI服务器函数（CE端的DLL中的函数）

你不能调用 Windows CE DLL 中的所有函数。函数结构必须符合下面的函数原型

6．3 阻 塞模式的例子代码< /span>

CE端 的DLL程序。

//=================================================================== 
#include <windows.h>                 // For all that Windows stuff 
    
// The following ensures that the function will be exported from the DLL 
// and that any C++ compilers used won&apos;t mangle the name. 
#ifdef __cplusplus 
extern "C" { 
#endif 
__declspec (dllexport) INT RAPIGetDiskSize (DWORD, BYTE *, DWORD *, 
                                            BYTE **, PVOID); 
#ifdef __cplusplus 
} 
#endif 
//=================================================================== 
// DllMain - DLL initialization entry point 
BOOL WINAPI DllMain (HANDLE hinstDLL, DWORD dwReason, 
                     LPVOID lpvReserved) { 
    return TRUE; 
} 
//=================================================================== 
// RAPIGetDiskSize - Returns the disk size and free space.  Called from 
// PC application using RAPI. 
// 
INT RAPIGetDiskSize (DWORD cbInput, BYTE *pInput, DWORD *pcbOutput, 
                     BYTE **ppOutput, PVOID reserved) { 
    PDWORD pdwLocal; 
    LPTSTR pPtr; 
    DWORD i; 
    int rc = 0; 
    ULARGE_INTEGER lnFree, lnTotal; 
    
    *pcbOutput = 0;            // Zero output bytes for now. 
if (!pInput) return –1;    // Make sure there is an input buffer. 
    // 判断是否已零结束的字符串 
    pPtr = (LPTSTR)pInput; 
    for (i = 0; i < cbInput / 2; i++) 
        if (!*pPtr++) 
            break; 
    // 如果是非零结束或字符串长度等于零返回－2 
if ((i >= cbInput / 2) || (i == 0))  
{ 
        LocalFree (pInput); 
        return -2; 
    } 
    
    // 调用GetDiskFreeSpaceEx函数 
    if (GetDiskFreeSpaceEx ((LPTSTR)pInput, NULL, &lnTotal, &lnFree)) { 
    
        // Allocate memory for the return buffer. 
        pdwLocal = (PDWORD) LocalAlloc (LPTR, 2 * sizeof (DWORD)); 
        if (pdwLocal) { 
            // Copy data from function to output buffer. 
            pdwLocal[0] = lnTotal.LowPart; 
            pdwLocal[1] = lnFree.LowPart; 
            // Specify size and buffer. 
            *pcbOutput = 2 * sizeof (DWORD); 
            *ppOutput = (PBYTE)pdwLocal; 
        } else 
            rc = GetLastError(); 
    } else 
        rc = GetLastError(); 
    // The function is responsible for freeing the input buffer. 
    LocalFree (pInput); 
    return rc; 
} 
__declspec (dllexport) INT RAPIGetDiskSize（… 

告诉链接程序已导出的山数，这样 外部模块就可以直接调 用这个函数。

  RAPIGetDiskSize的输入缓冲区被用来将目录名称传递到DLL，而输出缓冲区将返回传递的目录的总的磁盘空间和自由空间。输入和输出缓冲区的格式完全由 你决定，然而，输入缓冲区应使用 LocalAlloc来分配，这样RAPI库可以在它使用完后释放它。

   在PC端，调用堵塞模式RAPI服务器函数应像下 面这样。

// MyCeGetDiskFreeSpaceEx - Homegrown implementation of a RAPI 
// GetDiskFreeSpace function
BOOL MyCeGetDiskFreeSpaceEx (LPWSTR pszDir, PDWORD pdwTotal, 
 PDWORD pdwFree) { 
    HRESULT hr; 
    DWORD dwIn, dwOut; 
    LPBYTE pInput; 
    LPWSTR pPtr; 
    PDWORD pOut; 
    BOOL bRC = FALSE; 
    
    // Get length of Unicode string. 
    for (dwIn = 2, pPtr = pszDir; *pPtr++; dwIn+=2); 
    // Allocate buffer for input. 
    pInput = LocalAlloc (LPTR, dwIn); 
    if (!pInput) 
        return FALSE; 
    // Copy directory name into input buffer. 
    memcpy (pInput, pszDir, dwIn); 
    
    // Call function on Windows CE device. 
    hr = CeRapiInvoke (L"RapiServ", L"RAPIGetDiskSize", dwIn, 
                       pInput, &dwOut, (PBYTE *)&pOut, NULL, 0); 
    
    // If successful, return total and free values. 
    if (hr == 0) { 
        *pdwTotal = pOut[0]; 
        *pdwFree = pOut[1]; 
        bRC = TRUE; 
    } 
    LocalFree (pOut); 
    return bRC; 
} 

这个函数封装拉对CeRapiInvoke的调用，这样该调用看起来就像另一个 Windows CE RAPI调用。当函数返回时，由返回代码指出调用的 成功或失败。CeRapiInvoke将释放传递给它的输入缓冲区。然后从输入缓冲区复制这些数据，并且那个缓冲区将用LocalFree（）来释放。

6．4 流模式

流模式RAPI调用与阻塞模式不同，在流模式中，初始化RAPI调用将创建PC应用程序与Windows  CE设备上的服务器程序之间的链接。当在流模式中调用CeRapiInvoke时，这个函数将立即返回。你此时使用IRAPIStream接口来与服务器 DLL通信。你可以使用一个指针访问这个接口，该指针由CeRapiInvoke调用在由ppIRAPIStream指向的变量中返回。

DWORD dwIn, dwOut, cbBytes; 
IRAPIStream *pIRAPIStream; 
BYTE bBuff[BUFF_SIZE]; 
PBYTE pOut; 
HRESULT hr; 
    
// RAPI call 
hr = CeRapiInvoke (L"ServDLL", L"RAPIRmtFunc", dwIn, bBuff, 
                   &dwOut, &pOut, &pIRAPIStream, 0); 
if (hr == S_OK)  
{ 
    // Write 10 bytes. 
    pIRAPIStream->Write (bBuff, 10, &cbBytes); 
    // Read data from server. 
    pIRAPIStream->Read (bBuff, 10, &cbBytes); 
} 
pIRAPIStream->Release ();