Contents

gss_inquire_cred_by_mech(_:_:_:_:_:_:_:)

Obtains per-mechanism information about a credential.

Declaration

func gss_inquire_cred_by_mech(_ minor_status: UnsafeMutablePointer<OM_uint32>, _ cred_handle: gss_cred_id_t?, _ mech_type: gss_OID, _ cred_name: UnsafeMutablePointer<gss_name_t?>?, _ initiator_lifetime: UnsafeMutablePointer<OM_uint32>?, _ acceptor_lifetime: UnsafeMutablePointer<OM_uint32>?, _ cred_usage: UnsafeMutablePointer<gss_cred_usage_t>?) -> OM_uint32

Parameters

  • minor_status:

    A pointer to the secondary status result that provides additional information in case of failure.

  • cred_handle:

    The credential to inspect. Use Gss_c_no_credential to inquire about the default initiator principal.

  • mech_type:

    The mechanism for which information should be returned.

  • cred_name:

    A pointer the function uses to return the name that the credential asserts. Use Gss_release_name(_:_:) to free the name object’s memory when you are done with it. Set the parameter to NULL to ignore this output.

  • initiator_lifetime:

    A pointer the function uses to return the number of seconds for which the credential will remain valid for initiating security contexts, or 0 if the credential is expired or if the credential’s usage mechanism is Gss_c_accept. For credentials that do not support expiry, the function returns Gss_c_indefinite. Set to NULL to ignore this output.

  • acceptor_lifetime:

    A pointer the function uses to return the number of seconds for which the credential will remain valid for accepting security contexts, or 0 if the credential is expired or if the credential’s usage mechanism is Gss_c_initiate. For credentials that do not support expiry, the function returns Gss_c_indefinite. Set to NULL to ignore this output.

  • cred_usage:

    A pointer the function uses to return the credential usage. The value is one of Gss_c_accept, Gss_c_initiate, or Gss_c_both. Set to NULL to ignore this output.

Return Value

A status code set to GSS_S_COMPLETE on success. See Function Status for a description of other status outputs.

See Also

Inquiries