qkrb_parse_spnego_init_token()--Parse a SPNEGO Initiator Token

Syntax

 #include <qkrbspnego.h>

 OM_uint32 qkrb_parse_spnego_init_token(
     gss_buffer_desc     * init_token,
     qkrb_spnego_init_item_t **     parsed_token);

  Service Program Name: QSYS/QKRBSPNEGO
  Default Public Authority: *USE

  Threadsafe: Yes

The qkrb_parse_spnego_init_token() function parses a Simple and Protected GSS-API Negotiation (SPNEGO) Initiator Token and returns the results to the caller.

Authorities

No authorities are required.

Parameters

init_token (Input): The SPNEGO initiator token encoded in Abstract Syntax Notation 1 Distinguished Encoding Rules (ASN.1 DER) format.
parsed_token (Output): The information parsed from the initiator token. The application should release the parsed token information when it is no longer needed by calling the qkrb_free_spnego_init_item() routine.

Return Value

The return value is one of the following status codes:

GSS_SPNEGO_SUCCESS (0): The routine completed successfully.
GSS_SPNEGO_UNEXPECTED_ERR (1): The routine failed for unexpected reasons. Check the joblog for errors.
GSS_SPNEGO_NOMEM (2): Memory allocation failed.
GSS_SPNEGO_DEFECTIVE_TOKEN (3): Consistency checks performed on the input token failed.
GSS_SPNEGO_INCOMPLETE_RESULTS (4): Unable to successfully parse all token items. Partial results have been returned.

Related Information

For a description of the SPNEGO protocol, see RFC 2478 on the RFC Pages Link outside information center for The Simple and Protected GSS-API Negotiation Mechanism.

API introduced: V5R4

[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]