<!--
{
  "availability" : [
    "iOS: 9.0.0 -",
    "iPadOS: 9.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.11.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Contacts",
  "identifier" : "/documentation/Contacts/CNError",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Contacts"
    ],
    "preciseIdentifier" : "s:SC11CNErrorCodeLeV"
  },
  "title" : "CNError"
}
-->

# CNError

Error information that may be returned when using the methods of the Contacts framework.

```
struct CNError
```

## Topics

### Error codes

[`authorizationDenied`](/documentation/Contacts/CNError/authorizationDenied)

An error that indicates the system denied authorization.

[`changeHistoryExpired`](/documentation/Contacts/CNError/changeHistoryExpired)

An error that indicates the change history expired.

[`changeHistoryInvalidAnchor`](/documentation/Contacts/CNError/changeHistoryInvalidAnchor)

An error that indicates a change history anchor is invalid.

[`changeHistoryInvalidFetchRequest`](/documentation/Contacts/CNError/changeHistoryInvalidFetchRequest)

An error that indicates a change history fetch request is invalid.

[`clientIdentifierCollision`](/documentation/Contacts/CNError/clientIdentifierCollision)

An error that indicates a client identifier collision.

[`clientIdentifierDoesNotExist`](/documentation/Contacts/CNError/clientIdentifierDoesNotExist)

An error that indicates the client identifier doesn’t exist.

[`clientIdentifierInvalid`](/documentation/Contacts/CNError/clientIdentifierInvalid)

An error that indicates the client identifier is invalid.

[`communicationError`](/documentation/Contacts/CNError/communicationError)

An error that indicates a communication error occurred.

[`containmentCycle`](/documentation/Contacts/CNError/containmentCycle)

An error with the containment cycle.

[`containmentScope`](/documentation/Contacts/CNError/containmentScope)

An error with containment scope.

[`dataAccessError`](/documentation/Contacts/CNError/dataAccessError)

An error with data access.

[`featureDisabledByUser`](/documentation/Contacts/CNError/featureDisabledByUser)

An error that indicates the user disabled the feature.

[`featureNotAvailable`](/documentation/Contacts/CNError/featureNotAvailable)

An error that indicates the feature isn’t available.

[`insertedRecordAlreadyExists`](/documentation/Contacts/CNError/insertedRecordAlreadyExists)

An error that indicates the inserted record already exists.

[`noAccessableWritableContainers`](/documentation/Contacts/CNError/noAccessableWritableContainers)

An error that indicates there are no accessible writable containers.

[`parentContainerNotWritable`](/documentation/Contacts/CNError/parentContainerNotWritable)

An error that indicates the parent container isn’t writable.

[`parentRecordDoesNotExist`](/documentation/Contacts/CNError/parentRecordDoesNotExist)

An error that indicates the parent record doesn’t exist.

[`policyViolation`](/documentation/Contacts/CNError/policyViolation)

An error that indicates a policy violation.

[`predicateInvalid`](/documentation/Contacts/CNError/predicateInvalid)

An error that indicates an invalid predicate.

[`recordDoesNotExist`](/documentation/Contacts/CNError/recordDoesNotExist)

An error that indicates a record doesn’t exist.

[`recordIdentifierInvalid`](/documentation/Contacts/CNError/recordIdentifierInvalid)

An error that indicates a record identifier is invalid.

[`recordNotWritable`](/documentation/Contacts/CNError/recordNotWritable)

An error that indicates a record isn’t writable.

[`unauthorizedKeys`](/documentation/Contacts/CNError/unauthorizedKeys)

An error that indicates unauthorized keys usage.

[`vCardMalformed`](/documentation/Contacts/CNError/vCardMalformed)

An error that indicates a malformed vCard.

[`vCardSummarizationError`](/documentation/Contacts/CNError/vCardSummarizationError)

An error that indicates a vCard summarization problem.

[`validationConfigurationError`](/documentation/Contacts/CNError/validationConfigurationError)

An error with validation configuration.

[`validationMultipleErrors`](/documentation/Contacts/CNError/validationMultipleErrors)

An error that indicates the system encountered multiple validation errors.

[`validationTypeMismatch`](/documentation/Contacts/CNError/validationTypeMismatch)

A validation error that indicates a type mismatch.

### Error details

[`affectedRecordIdentifiers`](/documentation/Contacts/CNError/affectedRecordIdentifiers)

An array of strings that uniquely identify the records affected by the error.

[`affectedRecords`](/documentation/Contacts/CNError/affectedRecords)

An array of record objects for which the error applies.

[`CNError.Code`](/documentation/Contacts/CNError/Code)

Error codes that the system may return when you use Contacts framework methods.

[`keyPaths`](/documentation/Contacts/CNError/keyPaths)

An array of key paths associated with the error.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)