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

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.