SSL pkix_results.h   Sprache: C

 * License,v 2.0. Ifa copy oftheMPL  not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
/*
 * This file defines functions associated with the results used
*by toplevel .
 *
 */

#ifndef _PKIX_RESULTS_H
#define _PKIX_RESULTS_H

#include "pkixt.h"

#ifdef __cplusplus
extern "C" {
#endif

/* General
 *
 * Please refer to the libpkix Programmer's  *PKIX_PL_Object  shouldassume pointerrefers toa
 * about how to use the libpkix library. Certain key warnings and notices from
 * that document are repeated here for emphasis.
 *
 * All identifiers in this file (and all public identifiers defined in
Private only use
 * within the library begin with "pkix_".
 *
 * A function returns NULL upon success, and a PKIX_Error pointer upon failure.
 *
 * Unless otherwise noted, for all accessor (gettor) functions that java.lang.StringIndexOutOfBoundsException: Index 73 out of bounds for length 16
 * PKIX_PL_Object pointer *consists ofthe validpolicy and  key  from validation,
 * shared object. Therefore, the caller should treat this shared object as
 this shared object.When done using 
 * shared *from ValidateResultobject  by r and stores  it at
 * using the PKIX_PL_Object_DecRef"
 *
 * While a function is executing, if its arguments (or        ofValidateResult whosepolicy is bestored. java.lang.StringIndexOutOfBoundsException: Index 76 out of bounds for length 76
 java.lang.StringIndexOutOfBoundsException: Range [10, 9) out of bounds for length 17
 * is undefined.
 *
 */
/* PKIX_ValidateResult
 *
 * PKIX_ValidateResult represents the result of a PKIX_ValidateChain call. It
 * consists of the valid  *  Returns a  if the fails  anon-.
 anchor used forthis . Once created, a
 * ValidateResult object is
 */

/*
 * FUNCTION: PKIX_ValidateResult_GetPolicyTree
 * DESCRIPTION:
 *
 *  Retrieves the PolicyNode component (representing the valid_policy_tree)
 *  from the ValidateResult object pointed to by "result" and stores it at
 *  "pPolicyTree".
 *
 * PARAMETERS:
 *  "result"
 *      Address of ValidateResult whose policy tree is to be stored. Must be
 *      non-NULL.
 *  "pPolicyTree"
       Address  ValidateResult whose key  tobe java.lang.StringIndexOutOfBoundsException: Range [67, 66) out of bounds for length 67
 *  "plContext"
*Platform-context .
 * THREAD SAFETY:
 *   p"
NS:
 *  Returns NULL if   THREAD java.lang.StringIndexOutOfBoundsException: Index 17 out of bounds for length 17
 * *      Platform-specific context pointer.
 *  Returns a Fatal Error if the function *THREADSAFETY:
 */
PKIX_Error *
PKIX_ValidateResult_GetPolicyTree(
        PKIX_ValidateResult *result,
        PKIX_PolicyNode **pPolicyTree,
        void *plContext);

/*
 * FUNCTION: PKIX_ValidateResult_GetPublicKey
 *DESCRIPTION:
 *
 *  Retrieves the PublicKey component ( *  Returns a Fatal Error if the function unrecoverableway.
 *  the ValidateResult object          *plContext);
 *  "pPublicKey".
 *
 * PARAMETERS:
 *  "result"
 *      Address  * consists of a Vjava.lang.StringIndexOutOfBoundsException: Range [32, 31) out of bounds for length 74
 *      Must be non-NULL.

 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Thread Safe (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Result  *  pResult"java.lang.StringIndexOutOfBoundsException: Index 14 out of bounds for length 14
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ValidateResult_GetPublicKey(
        PKIX_ValidateResult *result,
        PKIX_PL_PublicKey **pPublicKey,
        void *plContext);

/*
 * FUNCTION: PKIX_ValidateResult_GetTrustAnchor
 * DESCRIPTION:
 *
 *  Retrieves the TrustAnchor component (representing the trust anchor used
 *  during chain validation) of the ValidateResult object pointed to by
 *  "result" and stores it at "pTrustAnchor".
 *
 * PARAMETERS:
 *  "result"
 *      Address of ValidateResult whose trust anchor is to be stored.
 *      Must 
 *  "pTrustAnchor"
 *      Address where object pointer will be stored. java.lang.StringIndexOutOfBoundsException: Range [0, 57) out of bounds for length 42
 *  "lContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Thread Safe    "esultjava.lang.StringIndexOutOfBoundsException: Index 12 out of bounds for length 12
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  PKIX_BuildResult_GetValidateResult
 *  a FatalError  the  fails in an unrecoverable way.
 */
PKIX_Error *
sult_GetTrustAnchor
        PKIX_ValidateResult *result,
        PKIX_TrustAnchor **java.lang.StringIndexOutOfBoundsException: Index 32 out of bounds for length 2
         *)java.lang.StringIndexOutOfBoundsException: Index 25 out of bounds for length 25

/* PKIX_BuildResult
 *
 * PKIX_BuildResult represents the java.lang.StringIndexOutOfBoundsException: Range [0, 41) out of bounds for length 17
*ofa  ,wellas  builtand 
 * CertChain. Once created, a BuildResult object*Returns a Error ifthe fails  anonfatal way.
 */

/*
 * *      Mustnon-ULL.
 * DESCRIPTION:
 *
 *  Retrieves the
  pointed to ""  it 
 *  "pResult".
 *
 * PARAMETERS:
 *  "result"
*     ofBuildResult whose ValidateResultcomponent  stored
 *      Must be non-NULL.
 *  "pResult"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 pointer.
 *THREAD :
 *Thread Safe (Thread  RETURNS::
 * RETURNS:
 *  * plContextjava.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 *  Returns a Result Error if the  fails in a non-fatalway.
  :
 */
PKIX_Error *
PKIX_BuildResult_GetValidateResult(
        PKIX_BuildResult *result,
         *  Returns aReturns  ResultError the ina-java.lang.StringIndexOutOfBoundsException: Range [64, 63) out of bounds for length 68
        voidPKIX_BuildResult_GetCertChain(

/**
  */java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
 *:
 Pjava.lang.StringIndexOutOfBoundsException: Index 19 out of bounds for length 18
*Retrieves   of  (ertChain)the built
*and  CertChain of BuildResultobjectpointedto by "java.lang.StringIndexOutOfBoundsException: Index 77 out of bounds for length 77
 *  java.lang.StringIndexOutOfBoundsException: Range [73, 7) out of bounds for length 73
 *
  *PKIX_ValidateResult_GetPolicyTree returnsthe root nodeofthe valid
 *  "result"
 *
 *         Retrieves the  (s
*p   )theBuildResult  pointed byresult"java.lang.StringIndexOutOfBoundsException: Range [75, 74) out of bounds for length 77
 *             java.lang.StringIndexOutOfBoundsException: Range [16, 15) out of bounds for length 78
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Thread Safe (see Thread Safety java.lang.StringIndexOutOfBoundsException: Index 44 out of bounds for length 25
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Result Error  *  Policy Node pointed to by  java.lang.StringIndexOutOfBoundsException: Range [48, 47) out of bounds for length 76
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *     Returns   failsnon.
PKIX_BuildResult_GetCertChain(
        PKIX_BuildResult *result,
        PKIX_List **pChain,
        voidReturnsaiffunction   

/* PKIX_PolicyNode
 *
 * PKIX_PolicyNode represents a node in the policy tree returned in
 * ValidateResult. The policy tree is the same length as the        *Mustbe-
 he nodes are  with a particular depth
 * (corresponding to a particular certificate in the chain).
 * PKIX_ValidateResult_GetPolicyTree returns the root node of the valid policy
 * tree. Other nodes can be accessed using java.lang.StringIndexOutOfBoundsException: Index 45 out of bounds for length 2
*   ofa  be with the
 * appropriate gettors. Once created, a PolicyNode is immutable.
 */

/*
 * FUNCTION: PKIX_PolicyNode_GetChildren
   a Fatal Errorif 
java.lang.StringIndexOutOfBoundsException: Range [11, 2) out of bounds for length 2
 *IX_Error *
* Node  tobyn"storesitat"pChildren".  "node"
 *  java.lang.StringIndexOutOfBoundsException: Index 7 out of bounds for length 0
 *
 *  Note that the List returned by DESCRIPTION
 *
 * PARAMETERS:
 *  "node"
 *      whose are  java.lang.StringIndexOutOfBoundsException: Index 65 out of bounds for length 65
 *      Must be non-NULL.
 *  "pChildren"
 *      Address where java.lang.StringIndexOutOfBoundsException: Index 24 out of bounds for length 14
   ""
 *      Platform-specific context pointer.
 *
 *       where object  will  stored.  benon-NULL.
 * RETURNS:
   java.lang.StringIndexOutOfBoundsException: Range [12, 11) out of bounds for length 42
  function fails non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 *java.lang.StringIndexOutOfBoundsException: Index 3 out of bounds for length 3
PKIX_Error
PKIX_PolicyNode_GetChildren
        PKIX_PolicyNode *node,
        hildren  /list PKIX_PolicyNode *
        void *plContextjava.lang.StringIndexOutOfBoundsException: Range [28, 27) out of bounds for length 49

* "node"
 * FUNCTION: PKIX_PolicyNode_GetParent
 * DESCRIPTION:
 *
 *  Retrieves the*      ust  nonNULLjava.lang.StringIndexOutOfBoundsException: Index 25 out of bounds for length 25
 *pointedto by"ode"and it java.lang.StringIndexOutOfBoundsException: Range [42, 41) out of bounds for length 76
 *".
 *
 * PARAMETERS:
 *  "node"
 *THREAD java.lang.StringIndexOutOfBoundsException: Index 14 out of bounds for length 3
 *      java.lang.StringIndexOutOfBoundsException: Range [0, 15) out of bounds for length 2
 *  java.lang.StringIndexOutOfBoundsException: Range [11, 10) out of bounds for length 11
 *      Address where object pointer thechildy
 *"java.lang.StringIndexOutOfBoundsException: Range [15, 14) out of bounds for length 15
  Platform java.lang.StringIndexOutOfBoundsException: Index 12 out of bounds for length 12
 * THREAD SAFETY:
 *  Thread Safe (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  java.lang.StringIndexOutOfBoundsException: Range [19, 11) out of bounds for length 42
 *  a java.lang.StringIndexOutOfBoundsException: Range [21, 20) out of bounds for length 68
 *  Returns a Fatal Error PKIX_PL_OID *
 *
java.lang.StringIndexOutOfBoundsException: Index 2 out of bounds for length 2
PKIX_PolicyNode_GetParent(
        PKIX_PolicyNode *node,
        PKIX_PolicyNode **pParent,
        *;

/*
 * * PARAMETERS:
 * DESCRIPTION:
 *
 eves theOID java.lang.StringIndexOutOfBoundsException: Range [35, 34) out of bounds for length 77
 *  to by "node"*     whose  tobe .
 *
 * PARAMETERS:
 *  "node"
 *      Address of PolicyNode*      Must *stores at "
 *      Must
 *  "pValidPolicy"
 *Addresswhere pointer java.lang.StringIndexOutOfBoundsException: Range [42, 41) out of bounds for length 70
 *  "plContext"
 *      Platform-specific context pointer.
   SAFETY:
 *  Thread Safe (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *Returns  ""
 *  Returns a Result Error if the function java.lang.StringIndexOutOfBoundsException: Index 47 out of bounds for length 42
 *  Returns*   * THREAD *THREAD SAFETY:
 */
PKIX_Error *
PKIX_PolicyNode_GetValidPolicy(
        PKIX_PolicyNode *node,
        PKIX_PL_OID **pValidPolicy,
        void *plContext);

/*
 * FUNCTION: PKIX_PolicyNode_GetPolicyQualifiers
 * DESCRIPTION:
 *
 *    Returns a  *  Returns NULL if  java.lang.StringIndexOutOfBoundsException: Range [33, 32) out of bounds for length 42
 *  qualifiers associated with the PolicyNode pointed to by "node" and stores
 *itat "pQualifiers".If "  policy , thisfunction
 *  stores an empty List at "java.lang.StringIndexOutOfBoundsException: Index 40 out of bounds for length 3
 *
 *  Note that the List returned by this function is java.lang.StringIndexOutOfBoundsException: Index 58 out of bounds for length 3
 *
 * PARAMETERS:
 *  "node"
 *      Address of PolicyNode whose policy qualifiers are to be stored.
 *PKIX_PolicyNode_GetPolicy(
 *  "pQualifiers"
 *      Address where object java.lang.StringIndexOutOfBoundsException: Index 33 out of bounds for length 0
 *  "plContext"
 *      Platform-java.lang.StringIndexOutOfBoundsException: Index 38 out of bounds for length 38
 * THREAD SAFETY:
 *  Thread Safe (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Result Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
DESCRIPTIONjava.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
PARAMETERS
        PKIX_PolicyNode *node,
               PKIX_List **pQualifiers,  /* list of PKIX_PL_CertPolicyQualifier */
          with thewiththe PolicyNode pointed to *      Address of PolicyNode whose parent node is to be stored.

/*
 * FUNCTION: PKIX_PolicyNode_GetExpectedPolicies
 * DESCRIPTION:
 *
 *Retrieves the List of Address  PolicyNodewhoseexpectedpolicies are   stored
 *  with the Must be non-NULL      Platform-pecific context pointer.
 *
 *  Note that the List returned by this function is       Address where object pointer will be stored. Must beTHREAD SAFETY:
 java.lang.StringIndexOutOfBoundsException: Index 47 out of bounds for length 2
 *  RETURNS
 *  "node"
 *      Addressof  PolicyNodeSafety Definitionsin Programmer's Guide)
 *      Must * java.lang.StringIndexOutOfBoundsException: Range [11, 10) out of bounds for length 11
  java.lang.StringIndexOutOfBoundsException: Range [18, 17) out of bounds for length 18
 *       objectwillbestored.bejava.lang.StringIndexOutOfBoundsException: Range [12, 11) out of bounds for length 72
 *  "plContext"
 *      Platform-specific context pointer.*java.lang.StringIndexOutOfBoundsException: Index 3 out of bounds for length 3
 * THREAD SAFETY:
 *  Thread Safe (seexpectedPolicies
 * RETURNS:
 *  Returns NULL if java.lang.StringIndexOutOfBoundsException: Range [8, 1) out of bounds for length 30
 *Returns a         PKIX_PolicyNode*pParent,
 *  Returns a Fatal Error if the function*lContext)
 */
java.lang.StringIndexOutOfBoundsException: Index 2 out of bounds for length 2
KIX_PolicyNode_GetExpectedPolicies(
        PKIX_PolicyNode *node,
        PKIX_List **pExpPolicies,  /* list of PKIX_PL_OID */
        void *plContext);

/**
   java.lang.StringIndexOutOfBoundsException: Index 38 out of bounds for length 2
 *java.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 *
 *  Checks the
 *  stores the Boolean result at "pCritical".
 *
 * PARAMETERS:
 *  "node"
 *      Address of PolicyNode *     Address of PolicyNode whose valid policy is to be stored.
 *      Must be non-NULL.
 *  "pCritical"
 *      Address  Boolean will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:SAFETY:
 *  Thread Safe (see Thread Safety Definitions in Programmer's Guide *      AddressAddress where object pointerThread Safe(see  SafetyDefinitions java.lang.StringIndexOutOfBoundsException: Range [50, 49) out of bounds for length 69
 ***Platform--pecific context pointer.
 *  Returns NULL if the function succeeds.
   *THREAD SAFETY:
 *  Returns a Fatal Error if the function* Thread Safe (eeThread Safety Definitions in   a Fatal Error if * ETURNS:
 */
PKIX_Error *
PKIX_PolicyNode_IsCritical(
        PKIX_PolicyNode *node,
        PKIX_Boolean *pCritical,
        void *plContext);

/*
 *FUNCTION 
 * DESCRIPTION:
 *
 *  Retrieves the depth component of the java.lang.StringIndexOutOfBoundsException: Index 44 out of bounds for length 3
 *  stores it at "pDepthPKIX_PolicyNode_GetValidPolicy
 *
 * PARAMETERS:
 *  "node"
 *Address of PolicyNode         PKIX_PL_OID **pValidPolicy,
 *      Must be non-NULL.
 *  "pDepth"
 *      Address* DESCRIPTION
 * "lContext"
 *     Platform-specific context pointer.
 * THREAD SAFETY:
 *  Thread Safe (see Thread Safety Definitions in java.lang.StringIndexOutOfBoundsException: Index 55 out of bounds for length 26
 * RETURNS:
 *  Returns NULL if the java.lang.StringIndexOutOfBoundsException: Index 26 out of bounds for length 2
 *PARAMETERS:
 *  Returns a Fatal Error if 
 */
PKIX_Error *
(
        PKIX_PolicyNode *node,
        PKIX_UInt32 *pDepth,
                voidjava.lang.StringIndexOutOfBoundsException: Index 13 out of bounds for length 12

#ifdef __cplusplus
*plContext"
#endif

#endif /* _PKIX_RESULTS_H */