Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

RapiConfig.exe is a desktop configuration tool that allows execution of provisioning XML on a Windows Mobile device that is connected to a desktop computer.

Copy Code 
RAPICONFIG [/M] [/P] filename

Parameters

/M

Return metadata

/P

Process XML. Required, if Rapiconfig.exe sends configuration XML to the device.

filename

Specifies XML configuration document

Remarks

This version of Rapiconfig.exe is located in the tools directory of the SDK for Windows Mobile 6.5. Either the mobile operator or the corporate manager can use this tool to configure the device. For example, to provision a device, you would type rapiconfig <provisioning.xml>. For information about provisioning a device using this tool, see Adding XML by using the Desktop Configuration Tool.

As of Windows Mobile Version 5.0, if you enable Normal mode on Windows Mobile PDAs by performing an action such as locking the device, you can use RapiConfig.exe to change it back to Privileged mode. If you change the Grant Manager Role from USER_AUTH to MANAGER, and then enable Normal mode, you can no longer change it back to Privileged mode using Rapiconfig.exe.

Remarks

Note:
RapiConfig uses RAPI APIs to perform operations on the device. RAPI calls will fail if the device has been configured to run in Restricted security mode, and therefore the RapiConfig tool will not function properly. For more information on RAPI security modes, see Security Policy Settings.

Remarks

Occasionally RapiConfig might return a device-specific error code. The following table shows the error codes that RapiConfig might return.

Value Description

CONFIG_E_OBJECTBUSY

Another instance of the configuration management service is currently running.

CONFIG_E_CANCELTIMEOUT

Waiting for the session to be timed out.

CONFIG_E_ENTRYNOTFOUND

No metabase entry was found.

CONFIG_E_CSPEXCEPTION

An exception occured in one of the Configuration Service Providers.

CONFIG_E_TRANSACTIONINGFAILURE

A configuration management service failed to roll back properly. The affected settings might be in an unknown state.

CONFIG_E_BAD_XML

The XML input is invalid or malformed.

See Also