ContactList.GetChangeTracker(String) Method

Definition

Gets a ContactChangeTracker that provides functionality for monitoring changes to Contact objects in the ContactList.

public:
 virtual ContactChangeTracker ^ GetChangeTracker(Platform::String ^ identity) = GetChangeTracker;
ContactChangeTracker GetChangeTracker(winrt::hstring const& identity);
public ContactChangeTracker GetChangeTracker(string identity);
function getChangeTracker(identity)
Public Function GetChangeTracker (identity As String) As ContactChangeTracker

Parameters

identity
String

Platform::String

winrt::hstring

A string that identifies the ContactChangeTracker instance in the ContactList.

Returns

A ContactChangeTracker that provides functionality for monitoring changes to Contact objects in the ContactList.

Windows requirements

Device family
Windows 10 Fall Creators Update (introduced in 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v5.0)
App capabilities
contactsSystem

Remarks

You can create multiple ContactChangeTracker instances by using this method. If you pass in a string that identifies a ContactChangeTracker that already exists in the ContactList, this method returns that instance. If the string that you pass into this method does not identify an existing an existing ContactChangeTracker, this method returns a new ContactChangeTracker.

You can use the IsTracking property of the ContactChangeTracker to determine whether change tracking is enabled for the ContactChangeTracker.

Applies to