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.