gss_import_name — Convert a printable string to an internal form

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_NAMETYPE	The `input_name_type` was unrecognized.
GSS_S_BAD_NAME	The `input_name_buffer` argument could not be interpreted as a name of the specified type.
GSS_S_BAD_MECH	The input name type was GSS_C_NT_EXPORT_NAME, but the mechanism contained within the input name is not supported.

HP OpenVMS Systems Documentation

gss_import_name — Convert a printable string to an internal form

ť Table of Contents

ť Glossary

ť Index

C Prototype

Arguments

Description

Return Values

		** About PDF files: The PDF files on this Web site can be read online or printed using Adobe® Acrobat® Reader. If you do not have this software installed on your system, you may download it from the Adobe Web site.