CNContactStoreMBS class

Online Documentation   -   Statistics   -   FAQ   -   Plugin Parts (All, Dependencies)   -   Class hierarchy

New in Version 22.2 22.3 22.4 22.5 23.0 23.1 23.2 23.3 23.4 23.5 24.0 24.1

The list of the   topics,   classes,   interfaces,   controls,   modules,   global methods by category,   global methods by name,   screenshots,   licenses   and   examples.

Platforms to show: All Mac Windows Linux Cross-Platform

CNContactStoreMBS class

Type Topic Plugin Version macOS Windows Linux iOS Targets
class Contacts MBS Mac64bit Plugin 16.3 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
The CNContactStore class is a thread-safe class that can fetch and save contacts, groups, and containers.

The CNContactStore class provides ways to execute fetch and save requests. There are a few recommended ways you can implement these requests in your app to load contacts:


Because CNContactStore fetch methods perform I/O, it’s recommended that you avoid using the main thread to execute fetches.

Your app must be code signed to see contacts.

Warning: Do not use in macOS 10.11 or earlier due to bugs, which have been fixed in macOS 10.12.

Constants

Constant Value Description
CNAuthorizationStatusAuthorized 3 One of the authorization status values the user can grant for an app to access the specified entity type. The application is authorized to access contact data.
CNAuthorizationStatusDenied 2 One of the authorization status values the user can grant for an app to access the specified entity type. The user explicitly denied access to contact data for the application.
CNAuthorizationStatusNotDetermined 0 One of the authorization status values the user can grant for an app to access the specified entity type. The user has not yet made a choice regarding whether the application may access contact data.
CNAuthorizationStatusRestricted 1 One of the authorization status values the user can grant for an app to access the specified entity type. The application is not authorized to access contact data. The user cannot change this application’s status, possibly due to active restrictions such as parental controls being in place.

Contact Types

Constant Value Description
CNEntityTypeContacts 0 Contacts

Error Codes

Constant Value Description
CNErrorCodeAuthorizationDenied 100 Authentication denied error.
CNErrorCodeCommunicationError 1 Communication error.
CNErrorCodeContainmentCycle 202 Code containment cycle error.
CNErrorCodeContainmentScope 203 Code containment scope error.
CNErrorCodeDataAccessError 2 Data access error.
CNErrorCodeInsertedRecordAlreadyExists 201 Record already exists.
CNErrorCodeParentRecordDoesNotExist 204 The contact does not exist error.
CNErrorCodePolicyViolation 500 Policy validation error.
CNErrorCodePredicateInvalid 400 Invalid predicate error.
CNErrorCodeRecordDoesNotExist 200 Record not found.
CNErrorCodeRecordIdentifierInvalid 205 Record identifier not valid.
CNErrorCodeValidationConfigurationError 302 Configuration validation error.
CNErrorCodeValidationMultipleErrors 300 Multiple validation error.
CNErrorCodeValidationTypeMismatch 301 Type mismatch validation error.

This class has no sub classes.

Some examples using this class:

Blog Entries

Release notes


The items on this page are in the following plugins: MBS Mac64bit Plugin.


CNContactRelationMBS   -   CNContactsUserDefaultsMBS


💬 Ask a question or report a problem