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 marks an individual property for inclusion or exclusion in the tracking scheme.

Syntax 

BOOL CeTrackProperty(
	PCEGUID pVolGuid,
	CEOID   oidDB,
	CEPROPID propid,
	BOOL fTrack
);

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.

oid

[in] Object identifier (OID) of the database to be tracked for the synchronization partner specified in the parameter pSyncPartnerGuid. This parameter cannot be set to NULL.

propid

[in] Property ID to include or exclude for tracking. This parameter cannot be set to NULL.

fTrack

[in] If set to TRUE, the property is tracked. If set to FALSE, changes to the property are not tracked.

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_ORDINAL

The name of the property could not be retrieved from the database.

ERROR_INVALID_PARAMETER

One or more parameters are invalid.

ERROR_NOT_FOUND

The database specified by oidor the property specified by propidcould not be found.

ERROR_NOT_SUPPORTED

Too many sessions are open.

Remarks

Use the CREATE_SYSTEMGUIDmacro to obtain the CEGUIDof the shared system volume.

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