Before you can invoke any RAPI functions, you must initialize the underlying communications layer between the host computer and the Windows ^®phone, which must be connected to the host computer through a cable or a cradle. There are two versions of the RAPI initialization function you can use: CeRapiInitand CeRapiInitEx. CeRapiInitdoes not return until the connection is made, an error occurs, or another thread calls CeRapiUninit.

CeRapiInitExworks slightly differently. Instead of blocking the calling thread, it returns an event handle to indicate when initialization is complete. Use CeRapiInitExto avoid blocking a thread inside a call to CeRapiInit. CeRapiInitExreturns immediately and continues initialization until the connection is made, until an error occurs, or until there is a call to CeRapiUninit. When CeRapiInitExis complete, it sets the event specified in the heRapiInitmember of the RAPIINITstructure. After calling CeRapiInitEx, check the return value to determine whether an error occurred. If the call was initially successful, call the MsgWaitForMultipleObjectsfunction to wait for the event handle passed back in the heRapiInitmember of the RAPIINITstructure. When the event is set, check the hrRapiInitmember of the RAPIINITstructure to determine whether the connection was successful. To shut down or to stop the connection process, call the CeRapiUnInitfunction.

The following interfaces are part of the Remote API (RAPI).

See Also