NAME

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

Synopsis

OM_uint32  gss_compare_name(
OM_uint32 ∗minor_status,
gss_name_t name1,
gss_name_t name2,
int ∗name_equal);

Parameters

Input

name1Specifies the first internal name. 

name2Specifies the second internal name. 

Output

name_equal
Returns one of the following values:

TRUEThe names are the same. 

FALSEThe 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).