GetImmutableHintValue
Reads an immutable value stored by the plug-in authorization mechanism.
Declaration
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 Mechanismcreate function.
- inKey:
A key indicating which value you want to retrieve. This key must correspond to one you specified when you used the Sethintvalue function to store a hint value.
- outValue:
On input, allocate a pointer to an Authorizationvalue structure. On output, the structure contains the size of the data and a pointer to the data. Because your Authorizationvalue structure does not own the data, you must not deallocate the structure or the data pointed to by the structure.
Return Value
A result code. Possible results are errAuthorizationSuccess (no error) and errAuthorizationInternal (Security Server internal error).
Discussion
This function behaves like GetHintValue, except that the hint is immutable.