NAME
gss_import_name() — convert a printable name to an internal form
SYNOPSIS
#include <gssapi.h>
- OM_uint32 gss_import_name (
OM_uint32 *minor_status,
const gss_buffer_t input_buffer_name,
const gss_OID input_name_type,
gss_name_t *output_name)
DESCRIPTION
The
gss_import_name()
routine converts a printable name to an
internal form.
Input Parameters
- input_name_buffer
Specifies the buffer containing the printable name to convert.
- input_name_type
Specifies the object identifier for the type of printable name. Applications
may specify either
GSS_C_NULL_OID
to use local system-specific
printable syntax, or an OID registered by the GSSAPI implementation to
name a particular namespace.
Output Parameters
- output_name
Returns the name in an internal form.
- minor_status
Returns a status code from the security mechanism.
STATUS CODES
The following status codes can be returned:
- GSS_S_COMPLETE
The routine was completed successfully.
- GSS_S_BAD_NAMETYPE
The name passed by the
input_name
parameter is
not recognized.
- GSS_S_BAD_NAME
The routine could not interpret the
input_name
parameter as a name of the type specified.
- GSS_S_BAD_MECH
The input nametype was
GSS_C_NT_EXPORT_NAME,
but the mechanism contained within the
input_name
is not supported.
- GSS_S_FAILURE
Check the
minor_status
parameter for details.
AUTHOR
gss_import_name()
was developed by Sun Microsystems, Inc.
Printable version
