NAME

gss_display_name — Provides to an application the textual representation of an opaque internal name

Synopsis

OM_uint32  gss_display_name(
OM_uint32 ∗minor_status,
gss_name_t input_name,
gss_buffer_t output_name_buffer,
gss_OID ∗output_name_type);

Parameters

Input

input_name
Specifies the name to convert to text.

Output

output_name_buffer
Returns the name as a character string.

output_name_type
Returns the type of name to display as a pointer to static storage.  The application should treat this as read-only.

minor_status
Returns a status code from the security mechanism.

Description

The gss_display_name() routine provides an application with the text form of an opaque internal name.  The application can use the text to display the name but not to print it. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

GSS_S_COMPLETE
The routine was completed successfully.

GSS_S_BAD_NAMETYPE
The name passed by the input_name parameter is recognized. 

GSS_S_BAD_NAME
An invalid name was passed by the input_name parameter. 

GSS_S_FAILURE
The routine failed.  Check the minor_status parameter for details. 

Related Information

Functions: gss_compare_name(3sec), gss_import_name(3sec), gss_release_name(3sec).