AggregateContactManager AggregateContactManager AggregateContactManager AggregateContactManager Class

Definition

Provides functionality for linking individual (raw) contacts across services together into a single aggregate contact.

public : sealed class AggregateContactManager : IAggregateContactManager, IAggregateContactManager2public sealed class AggregateContactManager : IAggregateContactManager, IAggregateContactManager2Public NotInheritable Class AggregateContactManager Implements IAggregateContactManager, IAggregateContactManager2// You can use this class in JavaScript.
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Remarks

All relevant methods of this class are static methods.

Methods

FindRawContactsAsync(Contact) FindRawContactsAsync(Contact) FindRawContactsAsync(Contact) FindRawContactsAsync(Contact)

Returns the list of individual (raw) contacts from the specified aggregate contact.

public : IAsyncOperation<IVectorView<Contact>> FindRawContactsAsync(Contact contact)public IAsyncOperation<IReadOnlyList<Contact>> FindRawContactsAsync(Contact contact)Public Function FindRawContactsAsync(contact As Contact) As IAsyncOperation( Of IReadOnlyListContact )// You can use this method in JavaScript.
Parameters
contact
Contact Contact Contact Contact

The aggregate contact from which to extract the list of raw contacts.

Returns
IAsyncOperation<IVectorView<Contact>> IAsyncOperation<IReadOnlyList<Contact>> IAsyncOperation<IReadOnlyList<Contact>> IAsyncOperation<IReadOnlyList<Contact>>

The list of individual (raw) contacts from the specified aggregate contact.

SetRemoteIdentificationInformationAsync(String, String, String) SetRemoteIdentificationInformationAsync(String, String, String) SetRemoteIdentificationInformationAsync(String, String, String) SetRemoteIdentificationInformationAsync(String, String, String)

Sets the identifier that specifies the remote contacts to link together with the contact data on your device.

public : IAsyncAction SetRemoteIdentificationInformationAsync(PlatForm::String contactListId, PlatForm::String remoteSourceId, PlatForm::String accountId)public IAsyncAction SetRemoteIdentificationInformationAsync(String contactListId, String remoteSourceId, String accountId)Public Function SetRemoteIdentificationInformationAsync(contactListId As String, remoteSourceId As String, accountId As String) As IAsyncAction// You can use this method in JavaScript.
Parameters
contactListId
PlatForm::String String String String

The remote contact list identifier.

remoteSourceId
PlatForm::String String String String

The identifier for the remote service, for example, “EXCH” for exchange accounts.

accountId
PlatForm::String String String String

The unique roaming identifier of the account for the network.

Returns
Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

TryLinkContactsAsync(Contact, Contact) TryLinkContactsAsync(Contact, Contact) TryLinkContactsAsync(Contact, Contact) TryLinkContactsAsync(Contact, Contact)

Asynchronously attempts to link contacts together to make an aggregate contact.

public : IAsyncOperation<Contact> TryLinkContactsAsync(Contact primaryContact, Contact secondaryContact)public IAsyncOperation<Contact> TryLinkContactsAsync(Contact primaryContact, Contact secondaryContact)Public Function TryLinkContactsAsync(primaryContact As Contact, secondaryContact As Contact) As IAsyncOperation( Of Contact )// You can use this method in JavaScript.
Parameters
primaryContact
Contact Contact Contact Contact

The first contact to link.

secondaryContact
Contact Contact Contact Contact

The second contact to link to the primaryContact.

Returns

Remarks

The primaryContact and secondaryContact objects can be any combination of raw and aggregate contacts.

TrySetPreferredSourceForPictureAsync(Contact, Contact) TrySetPreferredSourceForPictureAsync(Contact, Contact) TrySetPreferredSourceForPictureAsync(Contact, Contact) TrySetPreferredSourceForPictureAsync(Contact, Contact)

Chooses which of the raw contacts provides the main display picture for the aggregate.

public : IAsyncOperation<PlatForm::Boolean> TrySetPreferredSourceForPictureAsync(Contact aggregateContact, Contact rawContact)public IAsyncOperation<bool> TrySetPreferredSourceForPictureAsync(Contact aggregateContact, Contact rawContact)Public Function TrySetPreferredSourceForPictureAsync(aggregateContact As Contact, rawContact As Contact) As IAsyncOperation( Of bool )// You can use this method in JavaScript.
Parameters
aggregateContact
Contact Contact Contact Contact

The aggregate contact on which to set the picture.

rawContact
Contact Contact Contact Contact

The raw contact that provides the picture for the aggregate.

Returns

True if successful, otherwise false.

UnlinkRawContactAsync(Contact) UnlinkRawContactAsync(Contact) UnlinkRawContactAsync(Contact) UnlinkRawContactAsync(Contact)

Asynchronously unlinks a raw contact from the parent aggregate contact.

public : IAsyncAction UnlinkRawContactAsync(Contact contact)public IAsyncAction UnlinkRawContactAsync(Contact contact)Public Function UnlinkRawContactAsync(contact As Contact) As IAsyncAction// You can use this method in JavaScript.
Parameters
contact
Contact Contact Contact Contact

The raw contact to remove from the aggregate.

Returns

An async action that indicates the operation is complete.