HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 5 GSSAPI (Generic Security Services Application Programming Interface)

gss_compare_name — Allow application to compare two internal names

  Table of Contents



C Prototype

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


minor_status (output) 

An implementation-specific status code.

name1 (input) 

Internal-form name 1.

name2 (input) 

Internal-form name 2.

name_equal (output) 

A Boolean value.

TRUE — Names refer to the same entity.

FALSE — Names refer to different entities (strictly, the names are not known to refer to the same identity).


This routine allows an application to compare two internal-form names to determine whether they refer to the same entity. If either name presented to gss_compare_name denotes an anonymous principal, the routine will indicate that the two names do not refer to the same identity.

Return Values

This routine returns one of the following GSS status codes:


Successful completion.
GSS_S_BAD_NAMETYPEThe type contained within either name1 or name2 was unrecognized, or the names were of incomparable types.
GSS_S_BAD_NAMEOne or both of name1 or name2 was ill formed.