NAME
gss_compare_name() — allow an application to compare two internal names to determine whether they are equivalent
SYNOPSIS
#include <gssapi.h>
OM_uint32 gss_compare_name (
OM_uint32 *minor_status,
const gss_name_t name1,
const gss_name_t name2,
int *name_equal)
DESCRIPTION
The
gss_compare_name()
routine lets an application compare two internal
names to determine whether they are the same. This routine does not resolve
the names to see if they refer to the same object. It simply compares the
input names for equivalence. If either name presented to
gss_compare_name()
denotes an anonymous principal, the routines should indicate that the two
names do not refer to the same identity.
Input Parameters
- name1
Specifies the first internal name.
- name2
Specifies the second internal name.
Output Parameters
- name_equal
Returns one of the following values:
- True
The names are the same.
- False
The names are not the same.
- minor_status
Returns a status code from the security mechanism.
STATUS CODES
The following status codes can be returned:
- GSS_S_COMPLETE
The routine was completed successfully.
- GSS_S_BAD_NAMETYPE
The name passed by the
name1
or
name2
parameter is unsupported.
- GSS_S_BAD_NAME
An invalid name was passed by the
name1
or
name2
parameter.
- GSS_S_FAILURE
The routine failed. Check the
minor_status
parameter for details.
AUTHOR
gss_compare_name()
was developed by Sun Microsystems, Inc.