---
title: "gss_inquire_cred_by_oid(_:_:_:_:)"
framework: GSS
role: symbol
role_heading: Function
platforms: [iOS 5.0+, iPadOS 5.0+, Mac Catalyst 13.1+, macOS 10.7+, visionOS 1.0+]
path: "gss/gss_inquire_cred_by_oid(_:_:_:_:)"
---

# gss_inquire_cred_by_oid(_:_:_:_:)

Inquires about a particular characteristic of a credential.

## Declaration

```swift
func gss_inquire_cred_by_oid(_ minor_status: UnsafeMutablePointer<OM_uint32>, _ cred_handle: gss_cred_id_t, _ desired_object: gss_OID, _ data_set: UnsafeMutablePointer<gss_buffer_set_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 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 doc://com.apple.gss/documentation/GSS/GSS_C_NO_BUFFER_SET. Otherwise, call doc://com.apple.gss/documentation/GSS/gss_release_buffer_set(_:_:) to free the memory of this object when you are done with it.

## Return Value

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(_:_:_:_:_:_:)](gss/gss_inquire_cred(_:_:_:_:_:_:).md)
- [gss_inquire_cred_by_mech(_:_:_:_:_:_:_:)](gss/gss_inquire_cred_by_mech(_:_:_:_:_:_:_:).md)
- [GSSCredentialGetLifetime(_:)](gss/gsscredentialgetlifetime(_:).md)
