AuthorizationRightSet

Function AuthorizationRightSet 

Source
pub unsafe extern "C-unwind" fn AuthorizationRightSet(
    auth_ref: AuthorizationRef,
    right_name: NonNull<c_char>,
    right_definition: &CFType,
    description_key: Option<&CFString>,
    bundle: Option<&CFBundle>,
    locale_table_name: Option<&CFString>,
) -> i32
Available on crate features Authorization and AuthorizationDB only.
Expand description

Create or update a right entry. Only normal rights can be registered (wildcard rights are denied); wildcard rights are considered to be put in by an administrator putting together a site configuration.

Parameter authRef: (input) authRef to authorize modifications.

Parameter rightName: (input) the rightname (ASCII). Wildcard rightnames are not okay.

Parameter rightDefinition: (input) a CFString of the name of a rule to use (delegate) or CFDictionary containing keys defining one.

Parameter descriptionKey: (input/optional) a CFString to use as a key for looking up localized descriptions. If no localization is found this will be the description itself.

Parameter bundle: (input/optional) a bundle to get localizations from if not the main bundle.

Parameter localeTableName: (input/optional) stringtable name to get localizations from.

Returns: errAuthorizationSuccess 0 added right definition successfully.

errAuthorizationDenied -60005 Unable to create or update right definition.

errAuthorizationCanceled -60006 Authorization was canceled by user.

errAuthorizationInteractionNotAllowed -60007 Interaction was required but not possible.

ยงSafety

  • auth_ref must be a valid pointer.
  • right_name must be a valid pointer.
  • right_definition should be of the correct type.