CENOTIFICATION

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;
} CENOTINOTIFICATION; 

Members

  • dwSize
    Specifies the size of the CENOTIFICATION structure.

  • dwParam
    User-defined value assigned in the CENOTIFYREQUEST structure.

  • uType
    Describes the notification type. It is one of the following flags:

    Value Description
    DB_CEOID_CREATED New OID 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 a OEM replication process.
    DB_CEOID_DIRECTORY_DELETED Directory was deleted. Only available to a 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
    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.

Note   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

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

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.