Contents

gss_inquire_cred(_:_:_:_:_:_:)

Obtains information about a credential.

Declaration

func gss_inquire_cred(_ minor_status: UnsafeMutablePointer<OM_uint32>, _ cred_handle: gss_cred_id_t?, _ name_ret: UnsafeMutablePointer<gss_name_t?>?, _ lifetime: UnsafeMutablePointer<OM_uint32>?, _ cred_usage: UnsafeMutablePointer<gss_cred_usage_t>?, _ mechanisms: UnsafeMutablePointer<gss_OID_set?>?) -> 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.

  • name_ret:

    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.

  • lifetime:

    A pointer the function uses to return the number of seconds for which the credential will remain valid, or 0 if the credential is expired. 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.

  • mechanisms:

    A pointer the function uses to return the set of mechanisms that the credential supports. Use Gss_release_oid_set(_:_:) to free the set’s memory when you are done with it. Set the parameter 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