Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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 CEGUIDstructure 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 CEGUIDstructure 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 pVolGuidcould not be found.

ERROR_NOT_SUPPORTED

Too many sessions are open.

Remarks

Use the CREATE_SYSTEMGUIDmacro to obtain the CEGUIDof 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 GetLastErrorreturns ERROR_INVALID_PARAMETER.

Requirements

Header windbase.h
Library coredll.lib
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also