gss_canonicalize_name — Convert internal name to internal mechanism name

C Prototype

OM_uint32 gss_canonicalize_name(
        OM_uint32               * minor_status,
        const gss_name_t          input_name,
        const gss_OID             mech_type,
        gss_name_t              * output_name );

Arguments

minor_status (output)		An implementation-specific status code.
input_name (input)		The name for which a canonical form is desired.
mech_type (input)		The authentication mechanism for which the canonical form of the name is desired. The desired mechanism must be specified explicitly; no default is provided.
output_name (output)		The resultant canonical name. Storage associated with this name must be freed by the application after use by a call to `gss_release_name`.

Description

This routine generates a canonical mechanism name (MN) from an arbitrary internal name. The mechanism name is the name that would be returned to a context acceptor on successful authentication of a context where the initiator used the input_name in a successful call to gss_acquire_cred, specifying an OID set containing mech_type as its only member, followed by a call to gss_init_sec_context, specifying mech_type as the authentication mechanism.

Return Values

This routine returns one of the following GSS status codes:

GSS_S_COMPLETE	Successful completion.
GSS_S_BAD_MECH	The identified mechanism is not supported.
GSS_S_BAD_NAMETYPE	The provided internal name contains no elements that could be processed by the specified mechanism.
GSS_S_BAD_NAME	The `input_name` argument was ill formed.

HP OpenVMS Systems Documentation

gss_canonicalize_name — Convert internal name to internal mechanism name

ť 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.