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

# gss_indicate_mechs_by_attrs(_:_:_:_:_:)

Returns the set of mechanisms that fulfill the given criteria.

## Declaration

```swift
func gss_indicate_mechs_by_attrs(_ minor_status: UnsafeMutablePointer<OM_uint32>, _ desired_mech_attrs: gss_const_OID_set?, _ except_mech_attrs: gss_const_OID_set?, _ critical_mech_attrs: gss_const_OID_set?, _ mechs: UnsafeMutablePointer<gss_OID_set?>) -> OM_uint32
```

## Parameters

- `minor_status`: A pointer to the secondary status result that provides additional information in case of failure.
- `desired_mech_attrs`: A set of attributes, given by their OID, that a mechanism must have in order to appear in the results. See Mechanisms and Authentication in doc://com.apple.gss/documentation/GSS/security-mechanisms for a list of possible values.
- `except_mech_attrs`: A set of attributes, given by their OID, that the mechanism must not have in order to appear in the results. See Mechanisms and Authentication in doc://com.apple.gss/documentation/GSS/security-mechanisms for a list of possible values.
- `critical_mech_attrs`: A set of attributes, given by their OID, that the mechanism must know about, but not necessarily have, in order to appear in the results. See Mechanisms and Authentication in doc://com.apple.gss/documentation/GSS/security-mechanisms for a list of possible values.
- `mechs`: A pointer the function uses to return a new set of mechanisms that meet the given criteria. Release the set’s memory using a call to doc://com.apple.gss/documentation/GSS/gss_release_oid_set(_:_:) after you are done using it.

## Return Value

Return Value A status code set to GSS_S_COMPLETE on success. See Function Status for a complete enumeration of status outputs.

## See Also

### Queries

- [gss_indicate_mechs(_:_:)](gss/gss_indicate_mechs(_:_:).md)
- [gss_display_mech_attr(_:_:_:_:_:)](gss/gss_display_mech_attr(_:_:_:_:_:).md)
- [gss_inquire_attrs_for_mech(_:_:_:_:)](gss/gss_inquire_attrs_for_mech(_:_:_:_:).md)
- [gss_inquire_mech_for_saslname(_:_:_:)](gss/gss_inquire_mech_for_saslname(_:_:_:).md)
- [gss_inquire_saslname_for_mech(_:_:_:_:_:)](gss/gss_inquire_saslname_for_mech(_:_:_:_:_:).md)
