Function

gss_inquire_cred_by_oid

Inquires about a particular characteristic of a credential.

Declaration

OM_uint32 gss_inquire_cred_by_oid(OM_uint32 *minor_status, gss_cred_id_t cred_handle, gss_OID desired_object, gss_buffer_set_t  _Nonnull *data_set);

Parameters

minor_status

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

cred_handle

The credential to inquire about.

desired_object

The object identifier of the characteristic of the credential to return.

data_set

A pointer the function uses to return a set of buffers that contain the results across all of the credential's mechanisms. If the desired object is not found, this is set to GSS_C_NO_BUFFER_SET. Otherwise, call gss_release_buffer_set to free the memory of this object when you are done with it.

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

gss_inquire_cred

Obtains information about a credential.

gss_inquire_cred_by_mech

Obtains per-mechanism information about a credential.

GSSCredentialGetLifetime

Returns the remaining time in seconds before the credential expires.