CeTrackDatabase (EDB) (Compact 7)

  • Article

3/12/2014

This function starts tracking a database for a specified synchronization partner.

Syntax

BOOL CeTrackDatabase(
    PCEGUID pVolGuid,
    PCEGUID pSyncPartnerGuid,
    CEOID   oid,
    DWORD   dwTrackingFlags
);

Parameters

  • pVolGuid
    [in] Pointer to the CEGUID structure that contains the GUID of a mounted database volume or of the shared volume. This parameter cannot be set to NULL.
  • pSyncPartnerGuid
    [in] Pointer to the CEGUID structure that uniquely identifies the synchronization partner. This parameter cannot be set to NULL.
  • oid
    [in] The object identifier (OID) of the database to be tracked for the synchronization partner specified in pSyncPartnerGuid. This parameter cannot be set to NULL.

  • dwTrackingFlags
    [in] Specifies the tracking type and tracking mode. The flag may be a packed bitmask of tracking mode and tracking type.

    The following are possible values:

    • DB_TRACK_DELETE
    • DB_TRACK_INSERT
    • DB_TRACK_ROWIDENTITY_PK
    • DB_TRACK_ROWIDENTITY_ROWGUID
    • DB_TRACK_UPDATE

    Mode flags must be one of the following:

    • DB_TRACK_LEVEL_PROPEXCLUSIVE
    • DB_TRACK_LEVEL_PROPINCLUSIVE
    • DB_TRACK_LEVE_PROPVALCHANGE
    • DB_TRACK_LEVEL_RECORD

Return Value

TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError. The following table shows possible values.

Return Value Description

ERROR_BAD_LENGTH

The database is too big.

ERROR_FILE_NOT_FOUND

The tracking tables could not be found.

ERROR_INTERNAL_DB_CORRUPTION

The database is corrupted.

ERROR_INVALID_PARAMETER

One or more parameters are invalid.

ERROR_NOT_FOUND

The volume specified by pVolGuid could not be found.

ERROR_NOT_SUPPORTED

Too many sessions are open.

Remarks

Use the CREATE_SYSTEMGUID macro to obtain the CEGUID of the shared system volume. A maximum of 10 synchronization partners can be added per database.

Invoking the tracking functions on a CEDB volume causes an error, and GetLastError returns ERROR_INVALID_PARAMETER.

Requirements

Header

windbase.h

Library

coredll.lib

See Also

Reference

EDB Functions
CeRemoveDatabaseTracking (EDB)