CeSvcOpen

Opens and returns a handle to the registry root for a specified logical position, as specified by the CEUTIL constants shown in the table below. This is part of CEUTIL, a utility dll for dealing with desktop registry entries for Windows CE.

Syntax

HRESULT CeSvcOpen(
    UINT uSvc,
    LPTSTR pszPath,
    BOOL fCreate,
    PHCESVC phSvc
);

Parameters

uSvc

Logical subkey in registry as identified by CESVC_* keys.

The following table maps registry locations to pre-defined constants. MACHINE_ROOT is used for HKEY_LOCAL_MACHINE\Software\Microsoft\Windows CE and LOCAL_ROOT is used for HKEY_CURRENT_USER\Software\Microsoft\Windows CE Service.

Registry Key CEUTIL Constants Description

MACHINE_ROOT CESVC_ROOT_MACHINE Windows CE Services root hierarchy under HKEY_LOCAL_MACHINE

MACHINE_ROOT\Filters CESVC_FILTERS the Filters registry root. New filters should register themselves here

MACHINE_ROOT\CustomMenus CESVC_CUSTOM_MENUS Custom menus reg root

MACHINE_ROOT\Services CESVC_SERVICES_COMMON Services reg root

MACHINE_ROOT\Services \Synchronization CESVC_SYNC_COMMON Synchronization registry root. New sync services should register here

LOCAL_ROOT CESVC_ROOT_USER Windows CE Services root hierarchy under HKEY_CURRENT_USER

LOCAL_ROOT\Partners CESVC_DEVICES Individual device subkeys are created under this key

LOCAL_ROOT\Partners\<device id> CESVC_DEVICEX Particular device root subkey

LOCAL_ROOT\Partners\<selected device id> CESVC_DEVICE_SELECTED Root subkey for the currently selected device

LOCAL_ROOT\Partners\<device id>\Services CESVC_SERVICES_USER Root Services subkey for a particular device

LOCAL_ROOT\Partners\<device id>\Services\Synchronization CESVC_SYNC Synchronization reg root for a particular device

pszPath

Specifies either a subpath to append to the logical subkey, or a DWORD device identifier (if uSvc is CESVC_DEVICEX).

fCreate

TRUE—subkey should be created if it doesn't exist.

phSvc

Returns the logical handle to the registry subkey. This handle is equivalent to a HKEY and can be used by other CEUTIL APIs as well as Win32 registry manipulation routines.

Registry Key	CEUTIL Constants	Description
MACHINE_ROOT	CESVC_ROOT_MACHINE	Windows CE Services root hierarchy under HKEY_LOCAL_MACHINE
MACHINE_ROOT\Filters	CESVC_FILTERS	the Filters registry root. New filters should register themselves here
MACHINE_ROOT\CustomMenus	CESVC_CUSTOM_MENUS	Custom menus reg root
MACHINE_ROOT\Services	CESVC_SERVICES_COMMON	Services reg root
MACHINE_ROOT\Services \Synchronization	CESVC_SYNC_COMMON	Synchronization registry root. New sync services should register here
LOCAL_ROOT	CESVC_ROOT_USER	Windows CE Services root hierarchy under HKEY_CURRENT_USER
LOCAL_ROOT\Partners	CESVC_DEVICES	Individual device subkeys are created under this key
LOCAL_ROOT\Partners\<device id>	CESVC_DEVICEX	Particular device root subkey
LOCAL_ROOT\Partners\<selected device id>	CESVC_DEVICE_SELECTED	Root subkey for the currently selected device
LOCAL_ROOT\Partners\<device id>\Services	CESVC_SERVICES_USER	Root Services subkey for a particular device
LOCAL_ROOT\Partners\<device id>\Services\Synchronization	CESVC_SYNC	Synchronization reg root for a particular device

Return value

HRESULT: Standard Win32 error code.

Remarks

The first time a device is connected to the desktop and a partnership is created, the various synchronization and filter settings are copied from the MACHINE_ROOT to the partnership subkey under LOCAL_ROOT.