<!--
{
  "availability" : [
    "macCatalyst: 13.0.0 -",
    "macOS: 10.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Security",
  "identifier" : "/documentation/Security/AuthorizationCreateFromExternalForm(_:_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "Security"
    ],
    "preciseIdentifier" : "c:@F@AuthorizationCreateFromExternalForm"
  },
  "title" : "AuthorizationCreateFromExternalForm(_:_:)"
}
-->

# AuthorizationCreateFromExternalForm(_:_:)

Internalizes the external representation of an authorization reference.

```
func AuthorizationCreateFromExternalForm(_ extForm: UnsafePointer<AuthorizationExternalForm>, _ authorization: UnsafeMutablePointer<AuthorizationRef?>) -> OSStatus
```

## Parameters

`extForm`

A pointer to the external representation of the authorization reference you retrieve from the calling process.

`authorization`

A pointer to an authorization reference. On return, this points to the local copy of the authorization reference. The Security Server allocates the authorization reference for you, so you do not need to call the function [`AuthorizationCreate(_:_:_:_:)`](/documentation/Security/AuthorizationCreate(_:_:_:_:)).

## Return Value

A result code. See [Authorization Services Result Codes](/documentation/Security/authorization-services-result-codes).

## Discussion

When passing an authorization reference between processes, use this function to internalize the external representation of the authorization reference you created using the function [`AuthorizationMakeExternalForm(_:_:)`](/documentation/Security/AuthorizationMakeExternalForm(_:_:)).

---

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)