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)
|