The canonical contiguous
string form of input_name. Storage associated with
this string must be freed by the application after use by a call
to gss_release_buffer.
Description This routine produces a canonical contiguous string representation
of a mechanism name (MN), suitable for direct comparison (for example,
with memcmp) for use in authorization functions
(for example, matching entries in an access-control list). The input_name argument
must specify a valid MN (that is, an internal name generated by gss_accept_sec_context or
by gss_canonicalize_name).
Return
Values This routine returns one of the following GSS status codes:
GSS_S_COMPLETE
Successful completion.
GSS_S_NAME_NOT_MN
The provided internal name was not a mechanism name.
GSS_S_BAD_NAME
The provided internal name was ill formed.
GSS_S_BAD_NAMETYPE
The internal name was of a type not supported
by the GSSAPI implementation.