HP-UX Reference (11i v1 05/09) - 3 Library Functions A-M (vol 6)

gss_import_name(3) gss_import_name(3)

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 Speciﬁes the buffer containing the printable name to convert.

input_name_type Speciﬁes the object identiﬁer for the type of printable name. Applications may

specify either

GSS_C_NULL_OID

to use local system-speciﬁc 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

speciﬁed.

GSS_S_BAD_MECH The input nametype was

GSS_C_NT_EXPORT_NAME, but the mechanism con-

tained 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.