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 attaches some custom synchronization information to a changed record.

Syntax

BOOL CeAttachCustomTrackingData(
	HANDLE hChangeEnum,
	CEOID oidChangeRecord,
	BYTE* rgbData,
	DWORD ccb
);

Parameters

hChangeEnum

[in] Enumeration handle for the changed records obtained by the CeGetChangedRecords (EDB)function.

oidChangeRecord

[in] CEOID value of the changed record. This is not an ordinary EDB record, but a CEOID value obtained by a call to CeGetChangedRecords. This parameter cannot be set to NULL.

rgbData

[out] Buffer to receive the custom tracking data. This parameter cannot be set to NULL.

ccb

[in] Byte count of the data.

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_INVALID_HANDLE

The handle is invalid.

ERROR_INVALID_PARAMETER

One or more parameters are invalid.

Remarks

The number of bytes specified in ccbcannot be more than 1000.

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