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

 » Glossary

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

C Prototype

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

Arguments

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

Description

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:

GSS_S_COMPLETE

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.



gss_add_oid_set_member — Add an object identifier to a set
  		 


gss_canonicalize_name — Convert internal name to internal mechanism name