HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 5 GSSAPI (Generic Security Services Application Programming Interface)

gss_import_name — Convert a printable string to an internal form

  Table of Contents

  Glossary

  Index

C Prototype

OM_uint32 gss_import_name(
OM_uint32 * minor_status,
gss_buffer_t input_name_buffer,
gss_OID input_name_type,
gss_name_t * output_name );

Arguments

minor_status (output) 

An implementation-specific status code.

input_name_buffer (input) 

A buffer containing the contiguous string name to convert.

input_name_type (input)  

The object ID specifying the type of printable name. Applications may specify either GSS_C_NO_OID to use a local system-specific printable syntax, or an OID recognized by the GSSAPI implementation to name a specific namespace.

output_name (output) 

The returned name in internal form. Storage associated with this name must be freed by the application after use with a call to gss_release_name.

Description

This routine converts a contiguous string name to internal form. In general, the internal name returned (via the output_name argument) will not be an internal mechanism name; the exception to this is if the input_name_type indicates that the contiguous string provided via the input_name_buffer argument is of type GSS_C_NT_EXPORT_NAME, in which case the returned internal name will be a mechanism name for the mechanism that exported the name.

Return Values

This routine returns one of the following GSS status codes:

GSS_S_COMPLETE

Successful completion.
GSS_S_BAD_NAMETYPEThe input_name_type was unrecognized.
GSS_S_BAD_NAMEThe input_name_buffer argument could not be interpreted as a name of the specified type.
GSS_S_BAD_MECHThe input name type was GSS_C_NT_EXPORT_NAME, but the mechanism contained within the input name is not supported.