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 registers a synchronization partner with an EDB volume.

Syntax

BOOL CeAddSyncPartner(
	PCEGUID pVolGuid,
	PCEGUID pSyncPartnerGuid,
	LPCWSTR pwszFriendlyName,
	LPCWSTR pwszFullName  
);

Parameters

pVolGuid

[in] Pointer to the CEGUIDstructure that contains the globally unique identifier (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.

pwszFriendlyName

[in] Pointer to the NULL-terminated string that contains the friendly name of the synchronization partner. The maximum number of characters for this string is 128, excluding the terminating NULL character. This parameter cannot be set to NULL.

pwszFullName

[in] Pointer to NULL-terminated string containing the fully qualified name of the synchronization partner. The maximum number of characters for this string is 128, excluding the terminating NULL character. This parameter cannot be set to NULL.

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 is invalid.

ERROR_NOT_FOUND

The volume specified by GUID in the buffer pointed to by pVolGuidcould not be found.

ERROR_NOT_SUPPORTED

Too many sessions are open.

Remarks

Use the CREATE_SYSTEMGUIDmacro to obtain the CEGUID of the shared 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