CENOTIFYREQUEST

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure contains information to initialize the database and object store notification process. This structure is passed to the CeOpenDatabaseEx2 or CeRegisterReplNotification (OEM function) function to initiate the process.

Syntax

typedef struct _CENOTIFYREQUEST {
  DWORD dwSize;
  HWND hwnd;
  DWORD dwFlags;
  HANDLE hHeap;
  DWORD dwParam;
} CENOTIFYREQUEST;

Members

• dwSize
  Specifies the size of the CENOTIFYREQUEST structure.

• hwnd
  Handle to the window that receives notifications.

• dwFlags
  Specifies how notifications are handled. It is one of the following values.

  Value	Description
  0	Version 1.0 to version 2.0 behavior.
  CEDB_EXNOTIFICATION	Request to receive a pointer to a CENOTIFICATION structure that identifies which objects have changed. Applications working with mounted database volumes must set this flag to receive proper notification of changes in a volume.

• hHeap
  Handle to a heap that is used to allocate the notification structure. If this is NULL, the system allocates memory in the default heap of the process.

• dwParam
  User-defined parameter that is returned in the CENOTIFICATION structure when an application is notified of a change.

Remarks

The CENOTIFICATION structure returned by system must be freed after the notification has been processed. To free the CENOTIFICATION structure you must call CeFreeNotifcation.

Requirements

See Also

Concepts

RAPI Structures