CENOTIFICATION

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/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
    Specifies the size of the CENOTIFICATION structure.
  • dwParam
    User-defined value assigned in the CENOTIFIREQUEST structure.
  • uType
    Describes the notification type. It is one of the following flags.

    Value Description

    DB_CEOID_CREATED

    New object-identifier object was created.

    DB_CEOID_DATABASE_DELETED

    Database was deleted on a volume.

    DB_CEOID_RECORD_DELETED

    Record was deleted in a database.

    DB_CEOID_FILE_DELETED

    File was deleted. Only available to an original equipment manufacturer (OEM) replication process.

    DB_CEOID_DIRECTORY_DELETED

    Directory was deleted. Only available to an OEM replication process.

    DB_CEOID_CHANGED

    Object was modified.

  • guid
    Globally unique identifier (CEGUID) of the mounted database volume or object store that the notification applies.
  • oid
    Object identifier of the object that was changed.
  • oidParent
    Object identifier 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.

Note

Earlier versions of Windows Embedded CE assigned object identifiers to objects in other file systems, such as the file allocation table (FAT) file system. These object identifiers 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 object identifiers and the object store is the only volume that can return an object identifier.

Requirements

Header rapitypes.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

CeOpenDatabaseEx (RAPI)

Concepts

RAPI Structures