.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "gss_import_name" 3 "1.0.4" "gss" "gss"
.SH NAME
gss_import_name \- API function
.SH SYNOPSIS
.B #include <gss.h>
.sp
.BI "OM_uint32 gss_import_name(OM_uint32 * " minor_status ", const gss_buffer_t " input_name_buffer ", const gss_OID " input_name_type ", gss_name_t * " output_name ");"
.SH ARGUMENTS
.IP "OM_uint32 * minor_status" 12
(Integer, modify) Mechanism specific status code.
.IP "const gss_buffer_t input_name_buffer" 12
(buffer, octet\-string, read) Buffer containing
  contiguous string name to convert.
.IP "const gss_OID input_name_type" 12
(Object ID, read, optional) Object ID specifying
  type of printable name.  Applications may specify either
  GSS_C_NO_OID to use a mechanism\-specific default printable
  syntax, or an OID recognized by the GSS\-API implementation to
  name a specific namespace.
.IP "gss_name_t * output_name" 12
(gss_name_t, modify) Returned name in internal form.
  Storage associated with this name must be freed by the
  application after use with a call to \fBgss_release_name()\fP.
.SH "DESCRIPTION"
Convert a contiguous string name to internal form.  In general, the
internal name returned (via the \fIoutput_name\fP parameter) will not
be an MN; the exception to this is if the \fIinput_name_type\fP
indicates that the contiguous string provided via the
\fIinput_name_buffer\fP parameter is of type GSS_C_NT_EXPORT_NAME, in
which case the returned internal name will be an MN for the
mechanism that exported the name.
.SH "RETURN VALUE"

`GSS_S_COMPLETE`: Successful completion.

`GSS_S_BAD_NAMETYPE`: The input_name_type was unrecognized.

`GSS_S_BAD_NAME`: The input_name parameter could not be interpreted
as a name of the specified type.

`GSS_S_BAD_MECH`: The input name\-type was GSS_C_NT_EXPORT_NAME, but
the mechanism contained within the input\-name is not supported.
.SH "REPORTING BUGS"
Report bugs to <bug-gss@gnu.org>.
GNU Generic Security Service home page: http://www.gnu.org/software/gss/
General help using GNU software: http://www.gnu.org/gethelp/
.SH COPYRIGHT
Copyright \(co 2003-2022 Simon Josefsson.
.br
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
.SH "SEE ALSO"
The full documentation for
.B gss
is maintained as a Texinfo manual.  If the
.B info
and
.B gss
programs are properly installed at your site, the command
.IP
.B info gss
.PP
should give you access to the complete manual.