CENOTIFICATION

  • Article

This structure contains information about a change in the object store or a mounted database volume.

typedef struct _CENOTIFICATION {
  DWORD dwSize; 
  DWORD dwParam;
  UINT uType;
  CEGUID guid;
  CEOID oid;
  CEOID oidParent;
} CENOTIFICATION;

Members

  • dwSize
    DWORD that contains the size of the CENOTIFICATION structure.
  • dwParam
    DWORD that contains a user-defined value assigned in the CENOTIFYREQUEST structure.
  • uType
    Unsigned integer that describes the notification type. The following table shows the possible values.
    Value Description
    DB_CEOID_CREATED Indicates that a new OID object was created.
    DB_CEOID_DATABASE_DELETED Indicates that a database was deleted on a volume.
    DB_CEOID_RECORD_DELETED Indicates that a record was deleted in a database.
    DB_CEOID_FILE_DELETED Indicates that a file was deleted. Only available to a OEM replication process.
    DB_CEOID_DIRECTORY_DELETED Indicates that a directory was deleted. Only available to a OEM replication process.
    DB_CEOID_CHANGED Indicates that an object was modified.
  • guid
    Globally unique identifier (CEGUID) of the mounted database volume or object store that the notification applies.
  • oid
    Object identifier (OID) of the object that was changed.
  • oidParent
    OID of the parent object.

Remarks

The notification structure returned by the system must be freed after the notification has been processed. Call CeFreeNotification to free the notification structure.

Earlier versions of Windows CE assigned OIDs to objects in other file systems, such as the FAT file system. These OIDs were guaranteed to be unique within a volume, but not across multiple volumes. Effective with version 3.0, only objects in the object store have valid, unique OIDs and the object store is the only volume that can return an object identifier.

Requirements

OS Versions: Windows CE 2.10 and later.
Header: Windbase.h.

See Also

CeFreeNotification | CeOpenDatabaseEx

 Last updated on Friday, April 09, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.