gss_display_name(3sec)
Provides to an application the textual representation of an opaque internal name
Synopsis
#include <dce/gssapi.h>
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. |
Functions: