CENOTIFICATION (CEDB) (Windows Embedded CE 6.0)

1/6/2010

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

Syntax

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

Members

• dwSize
  DWORD that contains the size of this structure.

• dwParam
  DWORD that contains a user-defined value assigned in the CENOTIFYREQUEST (CEDB) structure.

• uType
  Unsigned integer that describes the notification type. The following table shows possible values.

  Value	Description
  DB_CEOID_CREATED	Indicates that a new object identifier (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 an OEM replication process.
  DB_CEOID_DIRECTORY_DELETED	Indicates that a directory was deleted. Only available to an 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
  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 the CeFreeNotification (CEDB) function to free the notification structure.

Earlier versions of Windows Embedded 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 Windows CE 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

See Also

Reference

CEDB Structures
CeFreeNotification (CEDB)
CeOpenDatabaseEx (CEDB)