<!--
{
  "documentType" : "article",
  "framework" : "Security",
  "identifier" : "/documentation/Security/authorization-services-result-codes",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Authorization Services Result Codes"
}
-->

# Authorization Services Result Codes

Recognize result codes specific to the authorization services API.

## Discussion

Use the [`SecCopyErrorMessageString(_:_:)`](/documentation/Security/SecCopyErrorMessageString(_:_:)) function to obtain a human readable string corresponding to these status codes.

The functions of the [Authorization Services](/documentation/Security/authorization-services) API may also return the general codes listed in [Security Framework Result Codes](/documentation/Security/security-framework-result-codes).

## Topics

### Codes

[`var errAuthorizationSuccess: OSStatus`](/documentation/Security/errAuthorizationSuccess)

The operation completed successfully.

[`var errAuthorizationInvalidSet: OSStatus`](/documentation/Security/errAuthorizationInvalidSet)

The set parameter is invalid.

[`var errAuthorizationInvalidRef: OSStatus`](/documentation/Security/errAuthorizationInvalidRef)

The authorization parameter is invalid.

[`var errAuthorizationInvalidTag: OSStatus`](/documentation/Security/errAuthorizationInvalidTag)

The tag parameter is invalid.

[`var errAuthorizationInvalidPointer: OSStatus`](/documentation/Security/errAuthorizationInvalidPointer)

The authorizedRights parameter is invalid.

[`var errAuthorizationDenied: OSStatus`](/documentation/Security/errAuthorizationDenied)

The Security Server denied authorization for one or more requested rights.

[`var errAuthorizationCanceled: OSStatus`](/documentation/Security/errAuthorizationCanceled)

The user canceled the operation.

[`var errAuthorizationInteractionNotAllowed: OSStatus`](/documentation/Security/errAuthorizationInteractionNotAllowed)

The Security Server denied authorization because no user interaction is allowed.

[`var errAuthorizationInternal: OSStatus`](/documentation/Security/errAuthorizationInternal)

An unrecognized internal error occurred.

[`var errAuthorizationExternalizeNotAllowed: OSStatus`](/documentation/Security/errAuthorizationExternalizeNotAllowed)

The Security Server denied externalization of the authorization reference.

[`var errAuthorizationInternalizeNotAllowed: OSStatus`](/documentation/Security/errAuthorizationInternalizeNotAllowed)

The Security Server denied internalization of the authorization reference.

[`var errAuthorizationInvalidFlags: OSStatus`](/documentation/Security/errAuthorizationInvalidFlags)

The flags parameter is invalid.

[`var errAuthorizationToolExecuteFailure: OSStatus`](/documentation/Security/errAuthorizationToolExecuteFailure)

The tool failed to execute.

[`var errAuthorizationToolEnvironmentError: OSStatus`](/documentation/Security/errAuthorizationToolEnvironmentError)

The attempt to execute the tool failed to return a success or an error code.

[`var errAuthorizationBadAddress: OSStatus`](/documentation/Security/errAuthorizationBadAddress)

The requested socket address is invalid.


---

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)