CENOTIFYREQUEST

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This structure contains information to initialize the database and object store notification process. This structure is passed to the CeOpenDatabaseExor 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 CENOTIFYREQUESTstructure.

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 CENOTIFICATIONstructure 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 CENOTIFICATIONstructure when an application is notified of a change.

Return Values

The CENOTIFICATIONstructure returned by system must be freed after the notification has been processed. To free the CENOTIFICATIONstructure 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.