---
title: "gss_canonicalize_name(_:_:_:_:)"
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_canonicalize_name(_:_:_:_:)"
---

# gss_canonicalize_name(_:_:_:_:)

Converts an internal name into a mechanism name.

## Declaration

```swift
func gss_canonicalize_name(_ minor_status: UnsafeMutablePointer<OM_uint32>, _ input_name: gss_name_t, _ mech_type: gss_OID, _ output_name: UnsafeMutablePointer<gss_name_t?>) -> OM_uint32
```

## Parameters

- `minor_status`: A pointer to the secondary status result that provides additional information in case of failure.
- `input_name`: The name to convert.
- `mech_type`: The mechanism for which the name should be converted.
- `output_name`: A pointer the function uses to return the canonicalized name. Release the name with a call to the doc://com.apple.gss/documentation/GSS/gss_release_name(_:_:) function 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 complete enumeration of status outputs.

## See Also

### Creation and Destruction

- [gss_name_t](gss/gss_name_t.md)
- [gss_const_name_t](gss/gss_const_name_t.md)
- [GSSNameCreateDisplayString(_:)](gss/gssnamecreatedisplaystring(_:).md)
- [GSSCreateName(_:_:_:)](gss/gsscreatename(_:_:_:).md)
- [gss_release_name(_:_:)](gss/gss_release_name(_:_:).md)