NAME

gss_import_name — Converts a printable name to an internal form

Synopsis

OM_uint32  gss_import_name(
OM_uint32 ∗minor_status,
gss_buffer_t input_buffer_name,
gss_OID input_name_type,
gss_name_t ∗output_name);

Parameters

Input

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.

Specify GSS_C_NULL_OID to use the DCE name.  You can explicitly request the DCE name by using GSSDCE_C_OID_DCE_NAME.  To help ensure portability of your application, use the default, GSS_C_NULL_OID. 

Output

output_name
Returns the name in an internal form.

minor_status
Returns a status code from the security mechanism.

Description

The gss_import_name() routine converts a printable name to an internal form. 

Status Codes

The following describes a partial list of codes (messages) that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all messages.  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_FAILURE
Check the minor status for details.

Related Information

Functions: gss_compare_name(3sec), gss_display_name(3sec), gss_release_name(3sec).