Partager via

CeStartDevMgmtService

  • Article

This function starts or terminates a device management service.

HANDLE CeStartDevMgmtService(
  int nAction,
  HWND hCallbackWnd
);

Parameters

  • nAction
    [in] Specifies what action to take. The following table shows the values for this parameter.
    Value Description
    DEVMGMT_SVC_STOP Shut down the device management service.
    DEVMGMT_SVC_START Start the device management service.
    DEVMGMT_SVC_GETSTATUS Get the service started or stopped status.
    DEVMGMT_SVC_REGWND Register the callback window.
    DEVMGMT_SVC_UNREGWND Unregister the callback window.
  • hCallbackWnd
    [in] Specifies the window handle to be registered or unregistered. You should take the following things into consideration when registering or unregistering a callback window:
    • Registering or unregistering a callback window does not work when the device management service is not running.
    • If you call this function many times to register the same window, the scheduler registers it only once.
    • You do not need to unregister a callback window if the device management service is going to be shut down.

Return Values

When starting or stopping the device management service, this function returns a handle to the service instance, hService, if it succeeds, or NULL if it fails.

When getting the service status, this function returns hService if it succeeds, or NULL if it fails.

When registering or unregistering a callback window, this function returns hService if it succeeds, or NULL if it fails.

When starting the service, if the function succeeds, the return value is actually the handle from GetServiceHandle(_T("DMSO:"), NULL, NULL);

An application can use this API to register the callback window. When the task list or package database is changed, the callback window receives the following message:

Message: WM_REFRESH_DMSDATA
lParam: Should be DMS_CALLBACK_MAGIC
wParam:DMS_REFRESH_TASKS : task list is changed
DMS_REFRESH_DB : package list is changed

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Devmgmt.h.

See Also

API Access

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.