CENOTIFYREQUEST

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

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

Parameters

  • 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.

Return Values

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

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS        

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CeFreeNotification, CeOpenDatabaseEx, CENOTIFICATION

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.