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_uint32Parameters
- 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
NULLto 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
NULLto 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
NULLto 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
NULLto 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.