Function

ABGroupCopyDistributionIdentifier(_:_:_:)

Returns the distribution identifier for the given property and person.

Declaration

func ABGroupCopyDistributionIdentifier(_ group: ABGroupRef!, _ person: ABPersonRef!, _ property: CFString!) -> Unmanaged<CFString>!

Parameters

group

The group object that person belongs to.

person

A person object whose distribution identifier you want to obtain.

property

The name of a person’s multi-value list property whose distribution identifier you want to obtain.

Return Value

The distribution identifier for person and property if it was set, otherwise returns the property’s primary identifier. If either person or property are NULL, this function returns NULL. Also, returns NULL if property is not a multi-value list property. You are responsible for releasing this object.

Discussion

Use the ABGroupSetDistributionIdentifier(_:_:_:_:) function to set the distribution identifier for a person’s multi-value list property.

See Also

Groups

func ABCopyArrayOfAllGroups(ABAddressBookRef!) -> Unmanaged<CFArray>!

Returns an array of all the groups in the Address Book database.

func ABGroupCopyArrayOfAllSubgroups(ABGroupRef!) -> Unmanaged<CFArray>!

Returns an array containing a group’s subgroups.

func ABGroupCopyParentGroups(ABGroupRef!) -> Unmanaged<CFArray>!

Returns an array containing a group’s parents—the groups that a group belongs to.

func ABGroupSetDistributionIdentifier(ABGroupRef!, ABPersonRef!, CFString!, CFString!) -> Bool

Assigning a specific distribution identifier for a person’s multi-value list property so that the group can be used as a distribution list (mailing list, in the case of an email property).