(Integer, read) GSS_C_GSS_CODE - status_value is a
GSS status code. GSS_C_MECH_CODE - status_value is a mechanism
status code.
const gss_OID mech_type
(Object ID, read, optional) Underlying mechanism (used
to interpret a minor status value). Supply GSS_C_NO_OID to obtain
the system default.
OM_uint32 * message_context
(Integer, read/modify) Should be initialized to
zero by the application prior to the first call. On return from
gss_display_status(), a non-zero status_value parameter indicates
that additional messages may be extracted from the status code
via subsequent calls to gss_display_status(), passing the same
status_value, status_type, mech_type, and message_context
parameters.
gss_buffer_t status_string
(buffer, character string, modify) Textual
interpretation of the status_value. Storage associated with this
parameter must be freed by the application after use with a call
to gss_release_buffer().
DESCRIPTION
Allows an application to obtain a textual representation of a
GSS-API status code, for display to the user or for logging
purposes. Since some status values may indicate multiple
conditions, applications may need to call gss_display_status
multiple times, each call generating a single text string. The
message_context parameter is used by gss_display_status to store
state information about which error messages have already been
extracted from a given status_value; message_context must be
initialized to 0 by the application prior to the first call, and
gss_display_status will return a non-zero value in this parameter
if there are further messages to extract.
The message_context parameter contains all state information
required by gss_display_status in order to extract further messages
from the status_value; even when a non-zero value is returned in
this parameter, the application is not required to call
gss_display_status again unless subsequent messages are desired.
The following code extracts all messages from a given status code
and prints them to stderr: