gss_str_to_oid()--Convert String Representation of an Object Identifier to an Internal OID Object
Syntax
#include <gssapi.h> OM_uint32 gss_str_to_oid( OM_uint32 * minor_status, gss_buffer_t input_string, gss_OID * output_oid);Service Program Name: QSYS/QKRBGSS
Default public authority: *USE
Threadsafe: Yes
The gss_str_to_oid() function converts the string representation of an object identifier to a gss_OID object.
Parameters
- minor_status (Output)
- A status code from the security mechanism.
- input_string (Input)
- The string to be converted.
- output_oid (Output)
- The object identifier. The gss_OID returned for this parameter should be released by calling the gss_release_oid() routine when it is no longer needed.
Return Value
The return value is one of the following status codes:
- 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. |
Usage Notes
- A string representation is a series of blank-separated or period-separated
numbers enclosed in braces. For example, the Kerberos V5 security mechanism
object identifier is represented as {1 2 840 113554 1 2 2}.
Not every coded character set identifier (CCSID) contains the left and right brace characters; however, alternative CCSID values often are available. For example, instead of using Greece 423, run the job with a default CCSID of 875.
- While the blank-separated form should be used for portability, the gss_str_to_oid() routine also accepts the period-separated form for compatibility with other applications. The gss_oid_to_str() routine, however, always generates the blank-separated form.
API introduced: V5R1
[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]