---
title: "gss_inquire_saslname_for_mech(_:_:_:_:_:)"
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_inquire_saslname_for_mech(_:_:_:_:_:)"
---

# gss_inquire_saslname_for_mech(_:_:_:_:_:)

Returns the Simple Authentication and Security Layer (SASL) protocol name for a given GSS-API mechanism.

## Declaration

```swift
func gss_inquire_saslname_for_mech(_ minor_status: UnsafeMutablePointer<OM_uint32>, _ desired_mech: gss_OID, _ sasl_mech_name: gss_buffer_t?, _ mech_name: gss_buffer_t?, _ mech_description: gss_buffer_t?) -> OM_uint32
```

## Parameters

- `minor_status`: A pointer to the secondary status result that provides additional information in case of failure.
- `desired_mech`: The GSS-API mechanism to query.
- `sasl_mech_name`: A buffer the function fills with the SASL G2 protocol name. Release this buffer with a call to doc://com.apple.gss/documentation/GSS/gss_release_buffer(_:_:) when you are done with it.
- `mech_name`: A buffer the function fills with a human readable version of the GSS-API protocol name. Release this buffer with a call to doc://com.apple.gss/documentation/GSS/gss_release_buffer(_:_:) when you are done with it.
- `mech_description`: A buffer the function fills with a description of the GSS-API protocol name. Release this buffer with a call to doc://com.apple.gss/documentation/GSS/gss_release_buffer(_:_:) when you are done with it.

## Return Value

Return Value A status code set to GSS_S_COMPLETE on success or GSS_S_BAD_MECH if the desired mechanism is unsupported. See Function Status for a complete enumeration of status outputs.

## See Also

### Queries

- [gss_indicate_mechs(_:_:)](gss/gss_indicate_mechs(_:_:).md)
- [gss_indicate_mechs_by_attrs(_:_:_:_:_:)](gss/gss_indicate_mechs_by_attrs(_:_:_:_:_:).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)
