gss_oid_to_str()--Convert OID Object to String Representation of Object

Syntax

 #include <gssapi.h>

 OM_uint32 gss_oid_to_str(
     OM_uint32 *    minor_status,
     gss_OID      input_oid,
     gss_buffer_t   output_string);

  Service Program Name: QSYS/QKRBGSS

  Default public authority: *USE

  Threadsafe: Yes

The gss_oid_to_str() function converts a gss_oid object to a string representation of the object identifier. The string representation consists of a series of blank-separated numbers enclosed in braces. The gss_str_to_oid() routine can be used to convert the string representation back to a gss_oid object.

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.

Parameters

minor_status (Output): A status code from the security mechanism.
input_oid (Input): The gss_OID to be converted.
output_string (Output): The string representation of the object identifier. The gss_buffer_t returned for this parameter should be released by calling the gss_release_buffer() 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

Configuration file

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 ]