PreviousNext

gss_import_name(3sec)

Converts a printable name to an internal form

Synopsis

#include <dce/gssapi.h>

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)