PreviousNext

gss_compare_name(3sec)

Allows an application to compare two internal names to determine whether they are equivalent

Synopsis

#include <dce/gssapi.h>

OM_uint32 gss_compare_name (
OM_uint32 *minor_status,
gss_name_t name1,
gss_name_t
name2,
int *
name_equal)

Parameters

Input

name1
Specifies the first internal name.

name2
Specifies the second internal name.

Output

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.

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.

Status Codes
The following describes a partial list of codes (messages) that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all messages. 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.
Related Information
Functions:

gss_display_name(3sec)

gss_import_name(3sec)

gss_release_name(3sec)