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

gss_export_name — Convert an internal mechanism name to export form

  Table of Contents

  Glossary

  Index

C Prototype

OM_uint32 gss_export_name(
(OM_uint32 * minor_status,
const gss_na input_name,
gss_buffer_t exported_name );

Arguments

minor_status (output) 

An implementation-specific status code.

input_name (input) 

The mechanism name to be exported.

exported_name (output) 

The canonical contiguous string form of input_name. Storage associated with this string must be freed by the application after use by a call to gss_release_buffer.

Description

This routine produces a canonical contiguous string representation of a mechanism name (MN), suitable for direct comparison (for example, with memcmp) for use in authorization functions (for example, matching entries in an access-control list). The input_name argument must specify a valid MN (that is, an internal name generated by gss_accept_sec_context or by gss_canonicalize_name).

Return Values

This routine returns one of the following GSS status codes:

GSS_S_COMPLETE

Successful completion.
GSS_S_NAME_NOT_MNThe provided internal name was not a mechanism name.
GSS_S_BAD_NAMEThe provided internal name was ill formed.

GSS_S_BAD_NAMETYPE

The internal name was of a type not supported by the GSSAPI implementation.