gss_compare_name()--Compare Two Internal GSS Names
Syntax
#include <gssapi.h> OM_uint32 gss_compare_name( OM_uint32 * minor_status, gss_name_t name1, gss_name_t name2, int * name_equal);Service Program Name: QSYS/QKRBGSS
Default public authority: *USE
Threadsafe: Yes
The gss_compare_name() function allows an application to compare two internal names to determine whether they refer to the same object. The two names must have an internal representation format in common to be comparable. The names are considered not equal if either name denotes an anonymous principal.
Parameters
- minor_status (Output)
- A status code from the security mechanism.
- name1 (Input)
- The first internal name.
- name2 (Input)
- The second internal name.
- name_equal (Output)
- Returns 1 if the names refer to the same object and 0 otherwise.
Return Value
The return value is one of the following status codes:
- GSS_S_BAD_NAME
- One of the input names is not valid.
- GSS_S_BAD_NAMETYPE
- The two name types are not comparable. The names must have an internal
representation in common to be comparable.
- GSS_S_COMPLETE
- The routine completed successfully.
- GSS_S_FAILURE
- The routine failed for reasons that are not defined at the GSS level. The minor_status return parameter contains a mechanism-dependent error code describing the reason for the failure.
Authorities
Object Referred to | Data Authority Required |
---|---|
Each directory in the path name preceding the configuration file | *X |
Configuration file | *R |
Error Messages
Message ID | Error Message Text |
---|---|
CPE3418 E | Possible APAR condition or hardware failure. |
API introduced: V5R1
[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]