CeRapiInit

The CeRapiInit function attempts to initialize the Windows CE Remote API.

Syntax

HRESULT CeRapiInit(void);

At a Glance

Header file: Rapi.h
Platforms: H/PC
Windows CE versions: 2.0 and later

Parameters

None.

Return Values

If this function succeeds, the return value is E_SUCCESS. If this function is called when already initialized, it returns E_FAIL.

Remarks

The functions CeRapiInit or CeRapiInitEx must be called before any remote API calls can be performed. They initialize the underlying communications layers between the desktop PC and the target platform device.

A call to CeRapiInit does not return until the connection is made, an error occurs, or another thread calls CeRapiUninit. The CeRapiInitEx function does not block the calling thread. Instead, it uses an event to signal when initialization is complete.

When writing applications for Windows CE versions 1.0 and 1.01, use the PegRapiInit function.

For more information about using RAPI functions, see Invoking Functions from a Desktop Computer.

See Also

CeRapiInitEx, RAPIINIT