---
title: GetImmutableHintValue
framework: security
role: symbol
role_heading: Instance Property
path: security/authorizationcallbacks/getimmutablehintvalue
---

# GetImmutableHintValue

Reads an immutable value stored by the plug-in authorization mechanism.

## Declaration

```occ
int (*)(struct __OpaqueAuthorizationEngine *, const char *, const struct AuthorizationValue **) GetImmutableHintValue;
```

## Parameters

- `inEngine`: An opaque handle that is passed to your plug-in when the authorization engine calls your doc://com.apple.security/documentation/Security/AuthorizationPluginInterface/MechanismCreate function.
- `inKey`: A key indicating which value you want to retrieve. This key must correspond to one you specified when you used the doc://com.apple.security/documentation/Security/AuthorizationCallbacks/SetHintValue function to store a hint value.
- `outValue`: On input, allocate a pointer to an doc://com.apple.security/documentation/Security/AuthorizationValue structure. On output, the structure contains the size of the data and a pointer to the data. Because your doc://com.apple.security/documentation/Security/AuthorizationValue structure does not own the data, you must not deallocate the structure or the data pointed to by the structure.

## Return Value

Return Value A result code. Possible results are errAuthorizationSuccess (no error) and errAuthorizationInternal (Security Server internal error).

## Discussion

Discussion This function behaves like GetHintValue, except that the hint is immutable.