skip book previous and next navigation links
go up to top of book: HP Open Source Security for OpenVMS Volume 3:... HP Open Source Security for OpenVMS Volume 3:...
go to beginning of chapter: GSSAPI (Generic Security Services Application... GSSAPI (Generic Security Services Application...
go to previous page: gss_get_mic  Generate a cryptographic MIC for a message gss_get_mic Generate a cryptographic MIC for a message
go to next page: gss_import_sec_context  Import a transferred contextgss_import_sec_context Import a transferred context
end of book navigation links

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.


go to previous page: gss_get_mic  Generate a cryptographic MIC for a message gss_get_mic Generate a cryptographic MIC for a message
go to next page: gss_import_sec_context  Import a transferred contextgss_import_sec_context Import a transferred context