Remote API Reference (Compact 7)

3/12/2014

The Remote API (RAPI) library supports applications that run on a desktop computer to perform actions on a remote Windows Embedded Compact-based device. The functionality that RAPI provides includes the ability to manipulate the file system on the remote device, including the creation and deletion of files and directories.

You can use RAPI functions to create and modify databases, either in the object store of a device, or in mounted database volumes.

RAPI applications can also query and modify registry keys, in addition to starting applications and invoking methods on a remote device.

Although most RAPI functions are duplicates of functions in the Windows Embedded Compact API, a few new functions extend the API. You can use these functions to initialize the RAPI subsystem, and enhance performance of the communication link by compressing iterative operations into one RAPI call.

To add this feature to your OS, see RAPI Catalog Items and Sysgen Variables.

The configuration settings for RAPI security policy are set to restricted mode by default. You can configure RAPI security policy by updating the following configuration settings.

ID Name Description

4097

RAPI Policy

SECPOLICY_RAPI

This setting limits access from remote applications that use RAPI to implement ActiveSync operations on Windows Embedded Compact 7 devices.

Default value is 2 for Compact 7.

The following list shows the possible values:

0 Blocked. Indicates that the ActiveSync service is shut down. RAPI calls are rejected.

1 Allow. Indicates full access to ActiveSync is provided. RAPI calls are allowed to process without restrictions.

2 Restricted. Indicates that access to ActiveSync is limited. Calls to CeRapiInvoke (RAPI) are blocked, the HKLM\comm\security registry key and its subkeys are read only, and the file defined in the HKLM\Init\Bootvars\"Systemhive" registry setting is read only.

The required role to modify this policy is SECROLE_MANAGER.

For more information, see the RAPI Reference on MSDN.

See Also

Reference

RAPI Enumerations
RAPI Functions
RAPI Interfaces
RAPI Structures
RAPI Unions

Concepts

RAPI Catalog Items and Sysgen Variables

Other Resources

Networking