AuthorizationMakeExternalForm

Function AuthorizationMakeExternalForm 

Source
pub unsafe extern "C-unwind" fn AuthorizationMakeExternalForm(
    authorization: AuthorizationRef,
    ext_form: NonNull<AuthorizationExternalForm>,
) -> i32
Available on crate feature Authorization only.
Expand description

Turn an Authorization into an external “byte blob” form so it can be transmitted to another process. Note that storing the external form somewhere will probably not do what you want, since authorizations are bounded by sessions, processes, and possibly time limits. This is for online transmission of authorizations.

Parameter authorization: The (valid) authorization reference to externalize

Parameter extForm: Pointer to an AuthorizationExternalForm variable to fill.

Returns: errAuthorizationSuccess 0 No error.

errAuthorizationExternalizeNotAllowed -60009 Externalizing this authorization is not allowed.

errAuthorizationInvalidRef -60002 The authorization parameter is invalid.

§Safety

  • authorization must be a valid pointer.
  • ext_form must be a valid pointer.