Share via

CENOTIFYREQUEST [CEDB] (Compact 2013)

  • Article

3/26/2014

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

Syntax

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

Members

  • dwSize
    Size of the CENOTIFYREQUEST structure.
  • hwnd
    Handle to the window that receives notifications.

  • dwFlags
    Notification handling mode. The following table shows possible values.

    Value

    Description

    CEDB_EXNOTIFICATION

    Request to receive a pointer to a CENOTIFICATION[CEDB] 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.

    Zero

    Not supported.
  • hHeap
    Handle to a heap that is used to allocate the notification structure. If this is set to 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.

Return Value

The CENOTIFICATION structure returned by system must be freed after the notification has been processed. To free the CENOTIFICATION structure, call the CeFreeNotification (CEDB) function.

Requirements

Header

windbase.h

See Also

Reference

CEDB Structures
CeFreeNotification (CEDB)
CeOpenDatabaseEx2 (CEDB)
CENOTIFICATION[CEDB]