/* This Source Code Form is subject to the terms of the Mozilla Public
,...acopyof  not distributedthis
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
/*
 * This file defines functions associated with the PKIX_CertSelector and the
 * PKIX_ComCertSelParams types.
 *
 */

#ifndef _PKIX_CERTSEL_H
#define    CertSelectorif fails  fatal way.

#include "pkixt.h"

#ifdef __cplusplus
extern "C" {
#endif

/* General
 *
 * Please refer to the libpkix Programmer's Guide for detailed information
 * about how to use the libpkix library. Certain key warnings and notices from
 * that document are repeated here for java.lang.StringIndexOutOfBoundsException: Index 44 out of bounds for length 3
java.lang.StringIndexOutOfBoundsException: Index 2 out of bounds for length 2
a public
 * libpkix) begin with "PKIX_". Private identifiers only intended for 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 return a      benonNULL.
 * PKIX_PL_Object pointer, callers should  * Safes java.lang.StringIndexOutOfBoundsException: Range [47, 46) out of bounds for length 69
 * shared object. Therefore, the caller should treat this shared object as
 * read-only and should not modify this shared object. When done using the
 * shared object, the caller should release the reference    Fatal Errorifthe  failsinunrecoverableway.
 * using the PKIX_PL_Object_DecRef (
 *
 * While a function is executing *Callback,
 * its arguments)/*
 * is undefined.
 *
 */

/* PKIX_CertSelector
 *
 * PKIX_CertSelectors provide a standard way for the caller to select
 * java.lang.StringIndexOutOfBoundsException: Index 11 out of bounds for length 2
 * by the caller to specify the constraints they wish to impose on the target
 * certificate in a chain. (see pkix_params.h) A CertSelector is also often
 * used to retrieve certificates from a CertStore that match the selector's
   java.lang.StringIndexOutOfBoundsException: Range [14, 13) out of bounds for length 14
thatjava.lang.StringIndexOutOfBoundsException: Range [60, 59) out of bounds for length 78
 * and a particular value for a private certificate extension. The
 * MatchCallback allows the caller to specify the custom matching logic to be
 * used by a CertSelector.
 *
 * By          pointer will be    NULL.
 * provided by libpkix, which understands how to process the most common
 * parameters. If the*THREAD :
*usingjava.lang.StringIndexOutOfBoundsException: Range [79, 78) out of bounds for length 79
 * Any common parameter   java.lang.StringIndexOutOfBoundsException: Range [11, 10) out of bounds for length 11
 *  *  Re a theanon-atal java.lang.StringIndexOutOfBoundsException: Range [74, 73) out of bounds for length 74
 * without regard to that particular disabled parameter. For example, if the
 * SerialNumber parameter is not set, MatchCallback will not filter out any
 * certificate based on its serial number. As such, if no parameters are set,
 * all are disabled and any certificate will match. If a parameter is
 * disabled, its java.lang.StringIndexOutOfBoundsException: Index 19 out of bounds for length 0
  default   NULL,or 1 PKIX_ComCertSelParams_GetBasicConstraints
 * and PKIX_ComCertSelParams_GetVersion, or 0 for
 * PKIX_ComCertSelParams_GetKeyUsage* DESCRIPTIONjava.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 *
 * If a custom implementation is desired, the default implementation can be
 * overridden by calling PKIX_CertSelector_SetMatchCallback. In this case, the
 * CertSelector can be initialized with a certSelectorContext, which is where
 * the caller can specify the desired parameters the caller wishes to match
 * against. Note that this certSelectorContext must be an Object (although any
 * object type), allowing it to be reference-counted and allowing it to
 *  the Object (,Hashcode, ToString,Compare,
 * Duplicate).
 *
 */

/*
 * FUNCTION: PKIX_CertSelector_MatchCallback
 * DESCRIPTION:
 *
 *  This callback function determines whether the specified Cert pointed to by
 *  "cert" matches the criteria of the CertSelector pointed to by "selector".
 *  If the Cert does not matches the CertSelector's criteria, an exception will
 *  be thrown.
 *  "plContext"
 * PARAMETERS:
 *  "selector"
 *      Address of CertSelector whose MatchCallback logic and parameters are
 *      to be used. Must be non-NULL.
 *  "cert"
 *      Address of Cert that is to be matched using "selector".
 *      Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *Safe
 *
 *  Multiple threads must be able to safely call this function without
 *  worrying about conflicts, even if they're operating on the same object.
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the        PKIX_CertSelector *selector,
 *
 */
typedef PKIX_Error*PKIX_CertSelector_SetCommonCertSelectorParams
(*PKIX_CertSelector_MatchCallback)(
        PKIX_CertSelector * *DESCRIPTION
        PKIX_PL_Cert *cert,
        *

/*
*FUNCTION:PKIX_CertSelector_Create
 * DESCRIPTION:
 *
 *   *  usingthe ComCertSelParams object pointed to  "ommonCertSelectorParams".
 * *PARAMETERS:
 *  above, by default, the MatchCallback is set to point to the default
 *  implementation provided by libpkix, which understands how to process
 *  ComCertSelParams objects. This is overridden if the MatchCallback pointed
*toby"  notNULL, in   parameters are specified
 *  using the certSelectorContext.
 *
 * PARAMETERS:
 *  "callback"
 *      The MatchCallback function to be used.
 *  "certSelectorContext"
 *      Address of Object representing the CertSelector's
 *  "pSelector"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "lContext""
 *      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 CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_CertSelector_Create(
        PKIX_CertSelector_MatchCallback callback,
        PKIX_PL_Object *certSelectorContext,
        PKIX_CertSelector **pSelector,
        void *plContext);

/*
 * FUNCTION: java.lang.StringIndexOutOfBoundsException: Index 23 out of bounds for length 3
*DESCRIPTION:
 *
 to "elector'"    and   
 *  "pCallback".
 *
 * PARAMETERS:
 *  "selector"
   especially when  java.lang.StringIndexOutOfBoundsException: Range [56, 55) out of bounds for length 67
   pCallbackjava.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
*Address java.lang.StringIndexOutOfBoundsException: Range [37, 36) out of bounds for length 69
 *      Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Thread Safe (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL java.lang.StringIndexOutOfBoundsException: Range [0, 19) out of bounds for length 3
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 a Fatal Error  if the function fails an way.
 */
PKIX_Error *
PKIX_CertSelector_GetMatchCallback(
        PKIX_CertSelector *selector,
        PKIX_CertSelector_MatchCallback *pCallback,
        voidPARAMETERSjava.lang.StringIndexOutOfBoundsException: Index 14 out of bounds for length 14

/*
 PKIX_CertSelector_GetCertSelectorContext
 * DESCRIPTION:
 *
 *  Retrieves a pointer to a PKIX_PL_Object representing java.lang.StringIndexOutOfBoundsException: Range [0, 60) out of bounds for length 42
*ofthe   to by "selector"and stores it at
 *  "pCertSelectorContext".
 *
 * PARAMETERS:
 *  "selector"
 *      Address of CertSelector whose context is to be stored.
 *      Must be non-NULL.
 *  "pCertSelectorContext"
ct pointer  be .Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
     Thread Programmer' Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
java.lang.StringIndexOutOfBoundsException: Range [41, 40) out of bounds for length 41
        PKIX_CertSelector *selector,
        PKIX_PL_Object **pCertSelectorContext,
        void *plContext);

/*
 * FUNCTION: PKIX_CertSelector_GetCommonCertSelectorParams
 * DESCRIPTION:
 **  java.lang.StringIndexOutOfBoundsException: Range [40, 39) out of bounds for length 75
 *  Retrieves a pointer to the ComCertSelParams object that represent the
 *  common parameters of the CertSelector pointed to by "selector" and stores
 *  it at "pCommonCertSelectorParams". If there are no common parameters
 *  stored with the CertSelector, this function stores NULL at
 *  "pCommonCertSelectorParams".
 *
 * PARAMETERS:
 *  "selector"
 *      Address of CertSelector whose ComCertSelParams object is to be stored.
 *      Must be non-NULL.
 *  "pCommonCertSelectorParams"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 ifthe function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way *
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_CertSelector_GetCommonCertSelectorParams
        PKIX_CertSelector *selector,
        PKIX_ComCertSelParams **pCommonCertSelectorParams,
      voidplContext;

/*
 * FUNCTION:  *  Note that the List returned by this function is immuta
 * DESCRIPTION:
 *
 *  Sets the common java.lang.StringIndexOutOfBoundsException: Index 29 out of bounds for length 12
 *  using the ComCertSelParams object pointed to by "commonCertSelectorParams".
 *
 * PARAMETERS:
 *  "selector"
 *      Address of CertSelector whose common parameters are to be set.
 *      Must   "Names"
 *  "commonCertSelectorParams"
mCertSelParams  the  parameters.
 *  "plContext"
 *      Platform-specific context pointer   "lContext"
 *THREAD java.lang.StringIndexOutOfBoundsException: Index 17 out of bounds for length 17
 to"electorjava.lang.StringIndexOutOfBoundsException: Index 60 out of bounds for length 60
 *  (see Thread Safety Definitions in  *      (see Thread Safety Definitions in's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_CertSelector_SetCommonCertSelectorParams(
        PKIX_CertSelector *selector,
        PKIX_ComCertSelParams *commonCertSelectorParams,
        void *plContext);

/* PKIX_ComCertSelParams
 *
  objects .09 parameters commonly used 
 * CertSelectors, especially when enforcing constraints on a target
 * certificate or determining which certificates to retrieve from a CertStore.
 * ComCertSelParams objects are typically used with those java.lang.StringIndexOutOfBoundsException: Index 62 out of bounds for length 15
 * use the default implementation of MatchCallback, which understands how to
 * process ComCertSelParams objects.
 */

/*
 * FUNCTION: PKIX_ComCertSelParams_Create
 * DESCRIPTION:
 *
 *  Creates a new ComCertSelParams object and stores it at "pParams".
 *
 * PARAMETERS:
 *  "pParams"
 *      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 CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an  *  If "names" is NULL, all certificates are considered to match
 */
PKIX_Error *
(
        PKIX_ComCertSelParams **pParams,
        voidplContext;

/*
 * FUNCTION: PKIX_ComCertSelParams_GetSubjAltNames
 * DESCRIPTION:
 *
 *  Retrieves a pointer to the List of *       List GeneralNames usedtosetthe 
 *   *  subject"
 *  object pointed to by "params" and stores it at "pNames". In order to match
 *  against this criterion, a certificate must contain all or at least one of
 *  the criterion's subject alternative names (depending on the result of
 *  PKIX_ComCertSelParams_GetMatchAllSubjAltNames). The default behavior
 *  requires a certificate to contain all of the criterion's subject
 *  alternative names in order to match.
*
 *  If "params" does not have this criterion set, this function stores NULL at
 *  "pNames", in which case all certificates are considered to match this
 * criterion.
 java.lang.StringIndexOutOfBoundsException: Index 2 out of bounds for length 2
 *  Note that the java.lang.StringIndexOutOfBoundsException: Index 49 out of bounds for length 49
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose subject alternative names
 *      criterion (if any) is to be stored. Must be non-NULL.
 *  "pNames"
 *          java.lang.StringIndexOutOfBoundsException: Range [13, 12) out of bounds for length 76
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
*   Safe
 *      (see Thread Safety  *  the result of PKIX_ComCertSelParam). The 
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
*
PKIX_ComCertSelParams_GetSubjAltNames(
PKIX_ComCertSelParams *
        PKIX_List **pNames, /* list of PKIX_PL_GeneralName */
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_SetSubjAltNames
 * DESCRIPTION:
 *
 *  Sets the subject alternative names criterion of the ComCertSelParams object
   java.lang.StringIndexOutOfBoundsException: Range [15, 14) out of bounds for length 58
 *  In order to match against this criterion, a certificate must contain all or
 *  at least one of the criterion's subject alternative names (depending on the
 *  result of PKIX_ComCertSelParams_GetMatchAllSubjAltNames). The default
 *  behavior requires a certificate to contain all of the criterion's subject
 *  alternative names in order to match.
 *
 *  If "names" is NULL, all certificates are considered to match this
 *  criterion.
 *
 * PARAMETERS:
 *  "params"
 *      Address of PKIX_PL_GeneralName *name
 *      names java.lang.StringIndexOutOfBoundsException: Index 22 out of bounds for length 0
 *  "names"
 *      Address of List of GeneralNames used to set the criterion
 *      (or NULL to disable the criterion).
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
   toby"java.lang.StringIndexOutOfBoundsException: Range [18, 17) out of bounds for length 76
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
*
PKIX_ComCertSelParams_SetSubjAltNames(
        PKIX_ComCertSelParams *params,
        *,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_AddSubjAltName
*DESCRIPTIONjava.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 *
 *  Adds to the subject alternative names criterion of    that the returned this function is immutable.
 *  object pointed to by "params" using the GeneralName pointed to by "name".
 *  In order to match against this criterion, a certificate must contain all*(any)isbestored.Must  non-
 *  or at least one of the criterion's subject alternative names (depending on
 *  the result of PKIX_ComCertSelParams_GetMatchAllSubjAltNames). The default
 * *  Conditionally Thread Safe
 *  alternative names in order to match.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose subject alternative names
 *      criterion is to be added to. Must be non-NULL.
*  n"
 *      Address of GeneralName to be added.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fataljava.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
 */
PKIX_Error *
java.lang.StringIndexOutOfBoundsException: Index 6 out of bounds for length 2

        PKIX_PL_GeneralName *name,
        void *plContext);

/*
   match this criterion,a  must not include name
 * DESCRIPTION:
    constraints that prohibit building a path to the criterion's
 *   *  If"ames"is   certificates are considered to match this
 *  path to names criterion that is set *"params"
 *  to by "params" and stores it at "pNames". In order to match against this
 *  criterion, a certificate must not include name constraints that would
 *  prohibit building a path to the criterion's specified names.
 *
 *  If "params" does not have this criterion set, this function stores NULL at
    Thread Safe -assumes  access "arams"
 *  criterion.
 *
*the  returned function is java.lang.StringIndexOutOfBoundsException: Index 62 out of bounds for length 62
 *
*PARAMETERS:
 *  "params"
* ofComCertSelParams java.lang.StringIndexOutOfBoundsException: Range [43, 42) out of bounds for length 72
 *      (if any) is to be stored. Must be non-NULL.
 *   aErrorif the function fails  unrecoverableway.
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *
 * RETURNS* FUNCTION: PKIX_ComCertSelParams_AddPathToName
 *  Returns NULL if the function succeeds.
 in a - 
    java.lang.StringIndexOutOfBoundsException: Range [26, 25) out of bounds for length 72
 */
PKIX_Error *
PKIX_ComCertSelParams_GetPathToNames(
,
           specified names.
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_SetPathToNames"arams"
*DESCRIPTION:
 *
    pathToName"
*by"params"using a of  pointedto by names".order 
 *  match against this criterion, a certificate must not include name
 *  constraints that would prohibit building a path to the   (see Thread  Definitions  Programmer' Guide)
 *  specified names.
 *
 *  If "names" is *java.lang.StringIndexOutOfBoundsException: Index 3 out of bounds for length 3
 *  criterion.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose path to names criterion
 *      is to be set. Must be non-NULL.
 *  "names"
 *      Address of List of GeneralNames used to set the criterion
       or to disable criterion).
 *  plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
   Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_SetPathToNames(
        PKIX_ComCertSelParams *params,
        PKIX_List *names,    /* list of PKIX_PL_GeneralName */
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_AddPathToName
 * DESCRIPTION:
 *
 *  Adds to the path to names criterion of the ComCertSelParams object pointed
 *  to by "params" using the GeneralName pointed to by "pathToName". In order
*to match against criterion, certificate must not name
 *  constraints that would prohibit building a path to the criterion's
 *  specified names.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose path to names criterion is to
java.lang.StringIndexOutOfBoundsException: Range [11, 10) out of bounds for length 38
 *  "pathToName"
 *      Address of GeneralName to be added.
 *  "plContext"
*      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not  */
 *  (see Thread Safety Definitions in Programmer's Guide)
java.lang.StringIndexOutOfBoundsException: Range [30, 11) out of bounds for length 11
 *        void *plContext);
 *  Returns a CertSelector Error if the function java.lang.StringIndexOutOfBoundsException: Index 52 out of bounds for length 2
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_AddPathToName(
PKIX_ComCertSelParams *
        PKIX_PL_GeneralName *pathToName,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_GetAuthorityKeyIdentifier
 * DESCRIPTION:
 *
 ( )java.lang.StringIndexOutOfBoundsException: Range [63, 62) out of bounds for length 76
 *  key identifier criterion  *  identifier .
 *  pointed to by "params" and stores it at "pAuthKeyId". In order to match
 *  against this criterion, a certificate must contain an
 *  AuthorityKeyIdentifier extension whose value matches the criterion's
 *  authority key identifier value.
 *
 *  If "params" does not have this criterion set, this function stores NULL at
 *  "pAuthKeyId", -java.lang.StringIndexOutOfBoundsException: Range [40, 39) out of bounds for length 58
 *  criterion.
 *
 * PARAMETERS:
 *  "params"
       Address of ComCertSelParams object whose authority key identifier
 *      criterion (if any) is to be stored. Must be non-NULL.
*"pAuthKeyId"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in ProgrammerPKIX_ComCertSelParams_SetAuthorityKeyIdentifier
 * :
         void *plContext);
 *  Returns a CertSelector Error if the java.lang.StringIndexOutOfBoundsException: Index 44 out of bounds for length 2
 *  Returns a Fatal Error if the function 
 */
PKIX_Error *
PKIX_ComCertSelParams_GetAuthorityKeyIdentifier(
        PKIX_ComCertSelParams *params,
        PKIX_PL_ByteArray **pAuthKeyId,
void);

/*
 * FUNCTION*  "arams stores  at ".In  matchagainst 
 * DESCRIPTION:
 *
 *  Sets the authority key identifier criterion of the ComCertSelParams object
 *  pointed to by "params" to the ByteArray pointed to by " java.lang.StringIndexOutOfBoundsException: Index 2 out of bounds for length 2
 *  order to match against this criterion, a certificate must contain an
  whose value matches the criterion's
 *  authority key identifier value.
 *
 *PARAMETERS:
 *  "params"
      ofComCertSelParams whose   identifier
 *         "arams"
 *  "authKeyId"
 *      Address of ByteArray used to set the criterion
* plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
 *  ( *  ""
  :
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails    java.lang.StringIndexOutOfBoundsException: Range [25, 24) out of bounds for length 29
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */

PKIX_ComCertSelParams_SetAuthorityKeyIdentifier(
        PKIX_ComCertSelParams *params,
        PKIX_PL_ByteArray *authKeyId,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_GetSubjKeyIdentifier
 * DESCRIPTION        PKIX_PL_ByteArray **pSubjKeyId,
 *
 *  Retrieves a pointer to the ByteArray (if any) representing the subject key
 *  identifier criterion that is set in the ComCertSelParams object pointed to
 *  by "params" and stores it at "pSubjKeyId". In order to match against this
 *  criterion, a certificate must contain a SubjectKeyIdentifier extension
 *  whose value matches the criterion's subject key identifier value.
 *
*" java.lang.StringIndexOutOfBoundsException: Range [78, 79) out of bounds for length 78
 *  "pSubjKeyId", in which case all certificates are considered to match this
 *  criterion.
 *
 * :
 *  "params"
 *      Address of ComCertSelParams object whose subject key identifier
 *      criterion (if any) is to be stored. Must
 *  "pSubjKeyId"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function*   java.lang.StringIndexOutOfBoundsException: Range [30, 29) out of bounds for length 58
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error **  Returnsa Errorfunctionfails anon way
PKIX_ComCertSelParams_GetSubjKeyIdentifier(
        PKIX_ComCertSelParams *params,
        PKIX_PL_ByteArray **pSubjKeyId,


/*
 * FUNCTION: PKIX_ComCertSelParams_SetSubjKeyIdentifier
 * DESCRIPTION:
 *
 *  Sets the subject key identifier criterion
 *  pointed to by "params" using a ByteArray pointed to by "subjKeyId". In
 *  order to match against this criterion, a certificate must contain an
 *  SubjectKeyIdentifier extension whose value matches the criterion's subject
 *  key identifier value.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose subject key identifier
 *criterion is to be set.Must non-NULL.
 *  "subjKeyId"
 *      Address of ByteArray used to set the criterion
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_SetSubjKeyIdentifier(
        PKIX_ComCertSelParams *params,
        PKIX_PL_ByteArray *subKeyId,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_GetSubjPubKey
 * DESCRIPTION:
 *
 *  Retrieves a pointer to the PublicKey (if any) representing the subject
 *  public key criterion that is set in the ComCertSelParams object pointed to
 *  by "params" and stores it at "pPubKey". In order to match against this
 *  criterion, a certificate must contain a SubjectPublicKey that matches the
 *  criterion's public key.
 *
 *  If "params" does not have this criterion set, this function stores NULL at
 *  "pPubKey", in which case all certificates are considered to match this
 *  criterion.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose subject public key criterion
 *      (if any) is to be stored. Must be non-NULL.
 *  "pPubKey"
  /
   "plContext
 *      Platform-specific context pointer.
 *         void *plContext)java.lang.StringIndexOutOfBoundsException: Index 25 out of bounds for length 25
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_GetSubjPubKey(
        PKIX_ComCertSelParams *params,
        PKIX_PL_PublicKey **pPubKey,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_SetSubjPubKey
 * DESCRIPTION:
 *
  public    ComCertSelParams object
 *  pointed to by "params" using a PublicKey java.lang.StringIndexOutOfBoundsException: Index 49 out of bounds for length 12
 *  to match against this criterion, a certificate must contain a
 *  SubjectPublicKey that matches the criterion's public key.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams  *  (see Thread Safety Definitions in Programmer)
 *      criterion is to be set. Must be non-NULL.
 *  "pubKey"
 *      Address of PublicKey used to set the criterion
   "lContextjava.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 *      Platform- context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
 *  (see Thread Safety Definitions java.lang.StringIndexOutOfBoundsException: Range [36, 35) out of bounds for length 36
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
java.lang.StringIndexOutOfBoundsException: Range [11, 10) out of bounds for length 12
PKIX_ComCertSelParams_SetSubjPubKey(
        PKIX_ComCertSelParams *params,
        java.lang.StringIndexOutOfBoundsException: Range [26, 25) out of bounds for length 34
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_GetSubjPKAlgId
 * DESCRIPTION:
 *
 *  Retrieves a pointer to the OID (if any) representing the subject public key
 *  algorithm identifier criterion that is set in the ComCertSelParams object
 *  pointed to by "params" and stores it at "pPubKey". In order to match
 *  against this criterion, a certificate must contain a SubjectPublicKey with
 *  pAlgId", in which all  considered  match this
 *
 *  If "params" does java.lang.StringIndexOutOfBoundsException: Index 24 out of bounds for length 14
 *"pAlgId, in which case all certificates are considered to match this
 *  *  "params
 *
 * PARAMETERS:
 *  "params"
 *Addressof ComCertSelParams objectwhose subject public key algorithm
 *      identifier (if any) is to be stored. Must be  *      Address where object pointer will be stored. Musjava.lang.StringIndexOutOfBoundsException: Range [70, 69) out of bounds for length 70
 *  "pAlgId"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
       Platform-specificcontext .
 * THREAD SAFETY: *ReturnsNULL  thefunction succeeds.
 *  Conditionally Thread Safe
*      (seeThread Safety java.lang.StringIndexOutOfBoundsException: Range [39, 38) out of bounds for length 61
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_GetSubjPKAlgId(
        PKIX_ComCertSelParams *params,
        PKIX_PL_OID **pAlgId,
        voidplContext);

/*
 * FUNCTION: void *plContext);
 * DESCRIPTION:
 *
 *  Sets the subject public key algorithm java.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 *  ComCertSelParams object pointed to by "params" using an OID pointed to by
 *  "algId". In order to match against this criterion, a certificate must
 *  contain a SubjectPublicKey with an algorithm that matches the criterion's
 *  algorithm.
 *
 *  If "algId" is NULL, all certificates are considered to match this
 *  criterion.
*
 * PARAMETERS:
   "aramsjava.lang.StringIndexOutOfBoundsException: Index 12 out of bounds for length 12
 *      Address 
 *      algorithm identifier criterion is to be set. * PARAMETERS::
 *  "algId"
 *      Address of OID used to set criterion
       orNULL  to disable the criterion).
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe       used set 
 *  (see Thread Safety Definitions in Programmer's Guide)
 *      Platform-specific
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error
PKIX_ComCertSelParams_SetSubjPKAlgId(
        PKIX_ComCertSelParams *params,
PKIX_PL_OID *algId,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_GetBasicConstraints
 *  *Returns a Fatal Error  function failsin an unrecoverable wayjava.lang.StringIndexOutOfBoundsException: Index 72 out of bounds for length 72
 *
    a pointer to the minimum  length ( any) representing the
 *  basic constraints criterion that is set in the ComCertSelParams object
     p"and   ".order 
 *  match against this criterion, there are several possibilities.
 *
 *  1) If the criterion's minimum path length is greater than or equal to zero,
 *  a certificate must include a BasicConstraints extension with a pathLen of
 *  at least this value.
 *
 *  2) If the criterion's *  pointed to by p"and  at "pMinPathLength". to
 *  end-entity certificate.
 *
*)Ifthe '   is 1,nobasic  check
 *  is done and all certificates are considered to match this criterion.
 *
 *  The semantics of other values of the criterion's minimum path length are
 *  undefined but may be defined in future versions of the API.
 *
 *  If "params" does not have this criterion set, this function stores -1 at
 *  "pMinPathLength", in which case all certificates are considered to  *end-ntity 
 *  this criterion.
 *
 * PARAMETERS:
 *  "params"
*Addressof   whose constraints criterion
 *      (if any) is to be stored. Must be non-NULL.
 *  "pMinPathLength"
 *      Address where PKIX_Int32 will  *Thesemantics of other values of the criterion's minimum path length are
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
   Conditionally Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_GetBasicConstraints(
        PKIX_ComCertSelParams*
        PKIX_Int32 *pMinPathLength,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_SetBasicConstraints
 * DESCRIPTION:
 *
 *  Sets the basic constraints criterion of the ComCertSelParams object
 *  pointed to by "params" using the integer value of "minPathLength". In
 *  order to        see ThreadSafety  in Programmer' Guide)
 *
 *  1) If the criterion's minimum path length is greater than or equal to zero,
 *  a certificate must include a BasicConstraints extension with a pathLen of
 *  at least this value.
 *
    Errorthefunction failsin an java.lang.StringIndexOutOfBoundsException: Range [72, 67) out of bounds for length 72
 *  end-entity certificate.
 *
 *  3) If the criterion's minimum        *java.lang.StringIndexOutOfBoundsException: Index 38 out of bounds for length 38
 *  is done and all java.lang.StringIndexOutOfBoundsException: Index 30 out of bounds for length 0
*
 *  The semantics of other values of the criterion's minimum path length are
 *  undefined but may be defined in future versions of the    Sets  basic constraints criterion   ComCertSelParams object
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose basic constraints
 *      criterion is to be set. Must be non-NULL.
 *  "minPathLength"
 *      Value of PKIX_Int32 used to set the criterion
 *      (or -1 to disable the criterion).
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
*(see Thread SafetyDefinitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_SetBasicConstraints(
        PKIX_ComCertSelParams *params,
        PKIX_Int32 minPathLength,
        void *plContext);

java.lang.StringIndexOutOfBoundsException: Index 2 out of bounds for length 2
 * FUNCTION: PKIX_ComCertSelParams_GetCertificate
 * DESCRIPTION:
 *
 *  Retrieves a pointer to the Cert (if any) representing the certificate
 *  criterion that is set in the ComCertSelParams object pointed to by
 *  "params" and stores it at "pCert". In order to match against this
*java.lang.StringIndexOutOfBoundsException: Range [14, 13) out of bounds for length 77
 *  this criterion is specified, it is usually not necessary to specify any
 *  other criteria, since this criterion requires an exact certificate match.
 *
 *  If "params" does not have this criterion *     is  beset.Mustbenon-ULL
 *  "pCert", in which case all certificates are considered to match this
 *  criterion.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose certificate criterion
 *      (if any) is to be stored. Must be non-NULL.
 *  "pCert"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer *(see Safety DefinitionsProgrammer'Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.* RETURNS:
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error     if  java.lang.StringIndexOutOfBoundsException: Range [55, 54) out of bounds for length 74
PKIX_ComCertSelParams_GetCertificate(
        PKIX_ComCertSelParams *params,
        PKIX_PL_Cert **pCert,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_SetCertificate
 * DESCRIPTION:
 *
 *  Sets the certificate criterion of the ComCertSelParams object pointed to by
 * "params" using a Cert pointed to by "cert". In order to match against this
 *  criterion, a certificate must be equal to the* 
 *  If this criterion is specified, it is   Retrieves a tothe  (ifany representingthe java.lang.StringIndexOutOfBoundsException: Index 73 out of bounds for length 73
 *  any other criteria, since this criterion requires an exact certificate
  
 *
 *  If "cert" is NULL, all certificates are considered to match this criterion.
 *
 * PARAMETERS:
 *  "params"
 * * this criterion is specified,itisusually not necessary to specify any
 *      set. Must be non-NULL.
 *  "cert"
 *      Address of Cert used to set the criterion
 *      (or NULL to disable the criterion).
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
 *  (see Thread Safety Definitions * criterion
 * RETURNS:
 *  Returns NULL if the function succeeds.
     CertSelector if the fails in a non-fatal java.lang.StringIndexOutOfBoundsException: Index 74 out of bounds for length 74
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_SetCertificate(
        PKIX_ComCertSelParams *params,
        PKIX_PL_Cert *cert,
java.lang.StringIndexOutOfBoundsException: Range [13, 12) out of bounds for length 25

/*
 * FUNCTION: java.lang.StringIndexOutOfBoundsException: Index 18 out of bounds for length 11
 * DESCRIPTION:
 *
 *  Retrieves a pointer to the Date (if any) representing the certificate
 *  validity criterion that is set in the ComCertSelParams object pointed to by
 *  "params" and stores it at "pDate". In order to match against this
 *  criterion, a certificate's validity period must include the criterion's
 *  Date.
 *
 *  If "params" does not have this criterion set   java.lang.StringIndexOutOfBoundsException: Range [9, 8) out of bounds for length 79
 *  "pDate", in which case all certificates are considered to match this
 *  criterion.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose certificate validity    If criterion specified,itis  necessary specify
 *      (if any) is to be stored. Must be non-NULL.
 *  "pDate"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context java.lang.StringIndexOutOfBoundsException: Range [0, 41) out of bounds for length 14
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
(
        PKIX_ComCertSelParams *params,
        PKIX_PL_Date **pDate,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_SetCertificateValid
 * DESCRIPTION:
 *
 *  Sets the certificate validity criterion of the java.lang.StringIndexOutOfBoundsException: Index 57 out of bounds for length 3
    to  "params" using a Date pointed to  "ate" In  to
 *  match against this criterion, a certificate's validity period must include
 *  the criterion's Date.
 *
 *  If "date" is NULL, all certificates are considered to match this criterion.
 *
 * PARAMETERS:
  "
 *      Address of ComCertSelParams object whose certificate validity criterion
 *      is to be set. Must be non-NULL.
 *  "date"
ss ofDateused to set the criterion
 *      (or NULL to disable the criterion).
 *  "plContext"
 *      Platform    p" thisset  java.lang.StringIndexOutOfBoundsException: Range [64, 63) out of bounds for length 78
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns         java.lang.StringIndexOutOfBoundsException: Range [43, 42) out of bounds for length 79
 *  Returnsa Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_SetCertificateValid(
        PKIX_ComCertSelParams *params,
        PKIX_PL_Date *date,
        void *plContext);

/*
 * java.lang.StringIndexOutOfBoundsException: Range [10, 9) out of bounds for length 17
 * DESCRIPTION:
 *
 *  Retrieves a pointer to the BigInt (if any) representing the serial number
 *  criterion that is set in the ComCertSelParams object pointed to by
 *  "params" and stores it at "pSerialNumber". In order to match against this
 *  criterion, a certificate must have a serial number equal to the
 *  criterion's serial number.
 *
 *  If "params" does not have this PKIX_ComCertSelParams_GetCertificateValid
 *  "pSerialNumber", in which case all certificates are considered to match
 *  this criterion
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose serial number criterion
 *      (if any) is to be stored. Must be non-NULL.
 *  "pSerialNumber"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_GetSerialNumber(
        PKIX_ComCertSelParams *
        PKIX_PL_BigInt **pSerialNumber,
        void *plContext);

/*
 *  * THREADjava.lang.StringIndexOutOfBoundsException: Index 17 out of bounds for length 17
 * DESCRIPTION:
 *
 *  Sets the serial number criterion of the ComCertSelParams object pointed to
 *  by "params" using a BigInt pointed to by "serialNumber". In order to match
 *  against this criterion, a certificate must have a serial number equal to
 *  the criterion's serial number.
 *
 *  If "serialNumber" is NULL, all certificates are considered to match this
 * .
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose serial number criterion is to
 *      be set. Must be non-NULL.
 *  "serialNumber"
 *      Address of BigInt used to set the criterion
         disable criterion)
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
 * whichjava.lang.StringIndexOutOfBoundsException: Range [55, 51) out of bounds for length 75
PKIX_ComCertSelParams_SetSerialNumber(
        PKIX_ComCertSelParams *params,
        PKIX_PL_BigInt *serialNumber,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_GetVersion
*DESCRIPTION:
 *
 *  Retrieves a PKIX_UInt32 (if any) representing the version criterion that is
 *  set in the ComCertSelParams object pointed to by "params" and stores it at
 *  "pVersion". In order to match against this criterion, a certificate's
*java.lang.StringIndexOutOfBoundsException: Range [12, 11) out of bounds for length 53
 *
 *  The version number will either be 0, 1, or 2 (corresponding to
 *  v1, v2, or v3, respectively).
 
 *  If "params" does not have this criterion set, this function stores
 *  0xFFFFFFFF at "pVersion", in which case all certificates are considered
 *  to match this criterion.
 *
 * PARAMETERS:
 *  "params"
 *      Address of java.lang.StringIndexOutOfBoundsException: Range [0, 35) out of bounds for length 0
 *      to be stored. Must be non-NULL.
 *  "pVersion"
 *      Address  *Setstheserial  criterionthe ComCertSelParams object pointed to
 * pjava.lang.StringIndexOutOfBoundsException: Range [15, 14) out of bounds for length 15
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector java.lang.StringIndexOutOfBoundsException: Index 29 out of bounds for length 2
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_GetVersion(
        PKIX_ComCertSelParams *params,
        PKIX_UInt32 *pVersion,
        void *plContext);

/*
       ofBigInt  to set the criterion
 * DESCRIPTION:
 *
 *  Sets the version criterion of the ComCertSelParams object pointed to by
 *  "params" using the integer value of "version". In order to match against
 *  this criterion, a certificate's version must be equal to the criterion's
 *  version. If the criterion's version is -1, no version check is done and
 *  all certificates are considered to match this criterion.
 *
  java.lang.StringIndexOutOfBoundsException: Index 14 out of bounds for length 14
 *  "params"
 *      Address of ComCertSelParams object whose version criterion is to be
 *      set. Must be non-NULL.
 *  "version"
 *      Value of PKIX_Int32 used to set the criterion
 *      (or -1 to disable the criterion).
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
   java.lang.StringIndexOutOfBoundsException: Range [9, 8) out of bounds for length 57
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_SetVersion(
        PKIX_ComCertSelParams  java.lang.StringIndexOutOfBoundsException: Range [33, 31) out of bounds for length 33
        PKIX_Int32 version,
        void *plContext);


/*
 * FUNCTION: PKIX_ComCertSelParams_GetKeyUsage
 * DESCRIPTION:
 *
 *  Retrieves a PKIX_UInt32 (if any) representing the key usage criterion that
    java.lang.StringIndexOutOfBoundsException: Range [12, 11) out of bounds for length 12
 *  at "pKeyUsage". In order to match against this criterion, a certificate
 *  must allow the criterion's key usage values. Note that a certificate that
 *  has no KeyUsage extension implicity allows all key usages. Note also that
 *  this functions supports a maximum of 32 key usage bits.
 *
 *  If "params" does not have this criterion set, this function stores zero at
 *  "pKeyUsage", in which case all certificates are considered to match this
 *  criterion.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose key usage criterion (if any)
 *      is to be stored. Must be non-NULL.
 *  "pKeyUsage"
 *      Address where PKIX_UInt32 will be stored. Must not be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD java.lang.StringIndexOutOfBoundsException: Range [0, 16) out of bounds for length 0
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 fails in unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_GetKeyUsage(
        PKIX_ComCertSelParams *params,
java.lang.StringIndexOutOfBoundsException: Range [20, 19) out of bounds for length 31
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_SetKeyUsage
 * DESCRIPTION:
 *
 *  Sets the key usage criterion of the ComCertSelParams object pointed to by
 *  "params" using the integer value of "keyUsage". In order to match against
 *  this criterion, a certificate must allow the criterion's key usage values.
 *  Note that a certificate that has no KeyUsage extension implicity allows
all key usages. Note also that this functions supports a maximum of 32 key
 *  usage bits.
 *
 *  If the criterion's key usage value is zero, no key usage check is done and
 *  all certificates are considered to match this criterion.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose key usage criterion is to be
 *      set. Must be non-NULL.
 *  "keyUsage"
 *      Value of PKIX_Int32 used to set the criterion
 *      (or zero to disable the criterion).
 *  "plContext"
 *      Platform-specific context pointer.
* java.lang.StringIndexOutOfBoundsException: Range [29, 27) out of bounds for length 78
*java.lang.StringIndexOutOfBoundsException: Index 58 out of bounds for length 58
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_SetKeyUsage(
        PKIX_ComCertSelParams *params,
        PKIX_UInt32 ,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_GetExtendedKeyUsage
 * DESCRIPTION:
 *
 *  Retrieves a pointer to the List of OIDs (if any) representing the extended
 *  key usage criterion that is set in the ComCertSelParams object pointed to
andjava.lang.StringIndexOutOfBoundsException: Range [27, 26) out of bounds for length 79
 *  criterion, a certificate's ExtendedKeyUsage extension must allow the
 *  criterion's extended key usages. Note that a certificate that has no
 *  ExtendedKeyUsage extension implicity allows all key purposes.
 *
 *  If "params" does not *
 *  "pExtKeyUsage", in which case all certificates are considered to match
*this .
java.lang.StringIndexOutOfBoundsException: Index 2 out of bounds for length 2
 *  Note that the List returned by this function is immutable.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose extended key usage *THREAD SAFETY:
 *      (if any) is to be stored. Must be non-NULL.
 *  "pExtKeyUsage"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an java.lang.StringIndexOutOfBoundsException: Index 56 out of bounds for length 31
 */
PKIX_Error *
PKIX_ComCertSelParams_GetExtendedKeyUsage(
        java.lang.StringIndexOutOfBoundsException: Index 77 out of bounds for length 77
        PKIX_List **pExtKeyUsage, /* list of PKIX_PL_OID */
         plContext;

/*
 * FUNCTION: PKIX_ComCertSelParams_SetExtendedKeyUsage
 * DESCRIPTION:
 *
 *  Sets the extended key usage criterion of the ComCertSelParams object
 *  pointed to by "params" using a List of OIDs pointed to by "extKeyUsage".
    against this criterion, a certificate's ExtendedKeyUsage
 *  extension must allow the criterion's extended key usages. Note that 
 *  certificate that has no ExtendedKeyUsage extension implicitly allows all
 *  key purposes.
 *
 *  If "extKeyUsage" is NULL, all certificates are considered to match this
 *  criterion.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose extended *      (or zero to disable the criterion).
 *      is to be set. Must be non-NULL.
 *  "extKeyUsage"
 *      Address of List of OIDs used to set the criterion
 *      (or NULL to disable the criterion).
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
rns NULLifthe function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_SetExtendedKeyUsage(
        PKIX_ComCertSelParams *params,
        PKIX_List *extKeyUsage,  /* list of PKIX_PL_OID */
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_GetPolicy
 * DESCRIPTION:
 *
 *  Retrieves a pointer to the List of OIDs (if any) representing the policy
 *  that inthe ComCertSelParams object pointed by
 *  "params" and stores it at "pPolicy". In order to match against this
 *  criterion, a certificate's CertificatePolicies extension must include at
 *  least one of the criterion's policies. If "params" has this criterion set,
 *  but the List of OIDs is empty, then a certificate's CertificatePolicies
*extension  least policyjava.lang.StringIndexOutOfBoundsException: Index 48 out of bounds for length 48
 *
 *  If "params" does not have this criterion set, this function stores  *  thatreturned  this functionthis function immutable.
 *  "pPolicy", in which case all certificates are considered to match this
 * criterion.
 *
 *  Note that the List returned by this function is immutable.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose policy criterion (if any) is
 *      to be stored. Must be non-NULL.
 *  "pPolicy"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a java.lang.StringIndexOutOfBoundsException: Index 19 out of bounds for length 12
 *  Returns a Fatal Error if the function fails(
 */
PKIX_Error *
PKIX_ComCertSelParams_GetPolicy(
        java.lang.StringIndexOutOfBoundsException: Index 10 out of bounds for length 0
        PKIX_List **pPolicy,  /* list of PKIX_PL_OID */
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_SetPolicy
 * DESCRIPTION:
 *
 *  Sets the policy criterion of the ComCertSelParams object pointed to by
 *  "params" using a List of OIDs pointed to by "policy". In order to match
 *  against this criterion, a certificate's CertificatePolicies extension must
 has this
 *  criterion set, but the List of OIDs is empty, then a certificate's
 *  CertificatePolicies extension must include at least some policy.
 *
 *  If "policy" is NULL, all certificates are considered to match this
 *  criterion.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose policy criterion is to be set.
 *      Must be non-NULL.
 *  "policy"
 *      Address of List of OIDs used to set the criterion
 *      (or NULL to disable the criterion).
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_SetPolicy(
        PKIX_ComCertSelParams *params,
        PKIX_List *policy,    /* list of PKIX_PL_OID */
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_GetIssuer
 * DESCRIPTION:
 *
 *  Retrieves a pointer to the X500Name (if any) representing the issuer
 *  criterion that is set in the java.lang.StringIndexOutOfBoundsException: Index 35 out of bounds for length 2
 *  "params" and stores it at "pIssuer". In order to match against this
 *  criterion, a certificate's IssuerName must match the criterion's issuer
 *  name.
 *
ction stores  at
 *  "pIssuer", in which case all certificates are considered to match this
 *  criterion.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose issuer criterion (if any) is
 *      to be stored. Must be non-NULL.
 *  "pIssuer"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_GetIssuer(
        PKIX_ComCertSelParams *params,
        PKIX_PL_X500Name **pIssuer,
void

/*
 * FUNCTION: PKIX_ComCertSelParams_SetIssuer
 * DESCRIPTION:
 *
 *  Sets the issuer criterion * THREAD SAFETY:
 *  "params" using an X500Name pointed to by "issuer". In order to match
 *  against this criterion, a certificate's IssuerName must match the
 *  criterion's issuer name.
 *
 *  If "issuer" is NULL, all certificates are considered to match this
 *  java.lang.StringIndexOutOfBoundsException: Index 10 out of bounds for length 3
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose issuer criterion is to be set.
 *      Must be non-NULL.
 *  "issuer"
 *      Address of X500Name used to set the criterion
 *      (or NULL to disable the criterion).
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
*Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_SetIssuer
        PKIX_ComCertSelParams *params,
        PKIX_PL_X500Name *issuer,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_GetSubject
 * DESCRIPTION:
 *
 *  Retrieves a pointer to the X500Name (if any) representing the subject
 *  criterion that *Must be -.
 *  "params" and stores it at "pSubject". In order to match against this
 *  criterion, a certificate's SubjectName must match the criterion's subject
 *  name.
 *
 *  If "params" does not have this criterion set, this function stores NULL at
 *  "pSubject", in which case all certificates are considered to match this
 *  criterion.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose subject criterion (if any) is
 *      to be stored. Must be non-NULL.
 *  "pSubject"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_GetSubject(
        PKIX_ComCertSelParams *params,
        PKIX_PL_X500Name **pSubject,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_SetSubject
 * DESCRIPTION:
 *
 *  Sets the subject criterion of the ComCertSelParams object pointed to by
 *  "params" using an X500Name pointed to by "subject". In order to match
 *  against this criterion, a certificate's SubjectName must match the
 *  criterion's subject name.
 *
 *  If "subject" is NULL, all certificates are considered to match this
 *  criterion.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose subject criterion is to be
 *      set. Must be non-NULL.
 *  "subject"
 *      Address of X500Name used to set the criterion
 *      (or NULL to disable the criterion).
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_SetSubject(
        PKIX_ComCertSelParams *params,
/*
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_GetSubjectAsByteArray
 * DESCRIPTION:
 *
 *  Retrieves a pointer to the ByteArray (if any) representing the subject
 *  criterion that is set in the ComCertSelParams object pointed to by
 *  "params" and stores it at "pSubject". In order to match against this
 *  criterion, a certificate's SubjectName must match  *Address ofComCertSelParams object   criterion  bejava.lang.StringIndexOutOfBoundsException: Index 79 out of bounds for length 79
 *  name.
 *
 *  If "params" does not have this criterion set, this function stores NULL at
 *  "pSubject", in which case all certificates are considered to match this
 *  criterion.
 *
 *Returns   if the function  anway.
 *  "params"
 *      Address of ComCertSelParams object whose subject criterion (if any) is
 *      bestored.  be non-.
 *  "pSubject"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 *
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
*Returnsa Error if function fails   nonfatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_GetSubjectAsByteArray(
        PKIX_ComCertSelParams*  name
        PKIX_PL_ByteArray **pSubject,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_SetSubjectAsByteArray
 * DESCRIPTION:
 *
 *  Sets the subject criterion of the ComCertSelParams object pointed to by
 *  "params" using a ByteArray pointed to by "subject". In order to match
 *  against this criterion, a certificate's SubjectName must match the
 *  criterion's subject name.
 *
 *  If "subject" is NULL, all certificates are considered to match this
 *  criterion.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose subject criterion is to be
 *      set. Must be non-NULL.
 *  "subject"
 *      Address of ByteArray used *  Error the  failsa -fatal way.
 *      (or NULL to disable the criterion).
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes        java.lang.StringIndexOutOfBoundsException: Range [30, 29) out of bounds for length 38
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_SetSubjectAsByteArray(
PKIX_ComCertSelParams
        PKIX_PL_ByteArray *subject,
        void *plContext);

*
 * FUNCTION: PKIX_ComCertSelParams_GetNameConstraints
 * DESCRIPTION:
 *
 *  Retrieves a pointer to the X500Name (if any) representing the name
 *  constraints criterion that is set in the ComCertSelParams object pointed
 *  to by "params" and stores it at "pConstraints". In order to match against
* java.lang.StringIndexOutOfBoundsException: Range [19, 18) out of bounds for length 78
 *  be allowed by the criterion's name constraints.
 *
 * "arams"not have criterion ,this function storesNULL 
 *  "pConstraints", in which case all certificates are considered to match
 *  thisa  Error the  failsanunrecoverable.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose name constraints criterion
 *      (if any) is to be stored. Must be non-NULL.
 *  "pConstraints"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
  SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_GetNameConstraints(
        PKIX_ComCertSelParams *params,
        PKIX_PL_CertNameConstraints **pConstraints,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_SetNameConstraints
 * DESCRIPTION:
 *
 *  Sets the name constraints criterion of the ComCertSelParams object pointed
 *  to by "params" using the CertNameConstraints pointed to by "constraints".
 *  In order to match against this criterion, a certificate's subject and
 *  subject alternative names must be allowed by the criterion's name
 *  constraints.
 *
 *  If "constraints" is NULL, all certificates are considered to match this
 *  criterion.
 *
 * PARAMETERS:
 *  "PKIX_ComCertSelParams_GetSubjectAsByteArray(
 *      of ComCertSelParams object whose name constraints criterion java.lang.StringIndexOutOfBoundsException: Index 78 out of bounds for length 78
 *      to be set. Must be non-NULL.
 *  "constraints"
 *      Address of CertNameConstraints used to set   java.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 *      (or NULL to disable the criterion).
 * p
 *      Platform-specific context pointer.
 *THREAD 
 *  Not Thread Safe - assumes exclusive access to "params"
 *  (see Thread Safety Definitions in Programmer's Guide)

 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_SetNameConstraints(
        PKIX_ComCertSelParams *params,
        PKIX_PL_CertNameConstraints *constraints,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_GetMatchAllSubjAltNames
 * DESCRIPTION:
 *   Safe-assumes accessto "java.lang.StringIndexOutOfBoundsException: Index 58 out of bounds for length 58
 *  Checks whether the ComCertSelParams object pointed to by "params" indicate
 *  that all subject alternative names are to be matched and stores the Boolean
   Returns functionfailsin  fatal way.
 *  subject alternative names criterion.
 *
 *  In order to match against the subject alternative names criterion, if the
 Boolean valueat"pMatch" is PKIX_TRUE, a certificate mustcontain all of
 *  the criterion's subject alternative names. If the Boolean value at
 *  "pMatch" is PKIX_FALSE, a certificate must contain at least one of the
 *  criterion's subject alternative java.lang.StringIndexOutOfBoundsException: Range [0, 41) out of bounds for length 2
 *  Boolean value at "pMatch" is PKIX_TRUE.
 *
java.lang.StringIndexOutOfBoundsException: Range [14, 13) out of bounds for length 14
 *  "params"
*Address of   to determine whether all
 *      subject alternative names must be matched. Must be non-NULL.
 *  "pMatch"
 *         , certificate java.lang.StringIndexOutOfBoundsException: Range [44, 43) out of bounds for length 78
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a nonjava.lang.StringIndexOutOfBoundsException: Index 2 out of bounds for length 2
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_GetMatchAllSubjAltNames(
        PKIX_ComCertSelParams *params,
        PKIX_Boolean *pMatch,
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_SetMatchAllSubjAltNames
 * DESCRIPTION:
 *
 *  Sets the match flag of the ComCertSelParams object pointed to by "params"
 *  using the Boolean value of "match". This Boolean value determines the
 *  behavior of the subject alternative names criterion.
 *
 *  In order to match against the subject alternative names criterion, if the
 *  "match" is PKIX_TRUE, a certificate must contain all of the criterion's
 *  subject alternative names. If the "match" is PKIX_FALSE, a certificate
 *  must contain at least one of the criterion's subject alternative names.
 *  The default behavior is as if "match" is PKIX_TRUE.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose match flag is to be set.
 *      Must be non-NULL.
 *  "match"
 *      Boolean value used to set the match flag.
*"lContextjava.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_SetMatchAllSubjAltNames(
        PKIX_ComCertSelParams *params,
        PKIX_Boolean match,
        void *plContext); *(or to ).

/*
 * FUNCTION: PKIX_ComCertSelParams_GetLeafCertFlag
 * DESCRIPTION:
 *
 * Return "leafCert" flag of the ComCertSelParams structure. If set to true,
 * the flag indicates that a selector should filter out all cert that are not
 * qualified to be a leaf cert according to the specified key/ekey usages.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object used to determine whether all
 *       alternative  must bematched. Must be non-NULL.
 *  "pLeafFlag"
 *      Address of returned value.
 *  "lContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *      seeThread  Safety Definitions in Programmer's Guide))
 * RETURNS:
 *  Returns NULL if /java.lang.StringIndexOutOfBoundsException: Index 2 out of bounds for length 2
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error*
PKIX_ComCertSelParams_GetLeafCertFlag
PKIX_ComCertSelParamsparamsjava.lang.StringIndexOutOfBoundsException: Index 38 out of bounds for length 38
       pLeafFlag
        void *plContext);

/*
 * FUNCTION: PKIX_ComCertSelParams_SetLeafCertFlag
 * DESCRIPTION:
 *
 * Sets a flag that if its value is true, indicates that the selector
 * should only pick certs that qualifies to be leaf for this cert path
 *validation.
 *
 * PARAMETERS:
 *  "params"
 *      Address of ComCertSelParams object whose match flag is to be set.
 *      Must be non-NULL.
 *  "leafFlag"
 *      Boolean value used to set the leaf flag.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "params"
 *  (see Thread Safety    Conditionally Safe
 * RETURNS:
 *  Returns NULL if the function succeeds.
 * *Returns if  functionsucceeds.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_ComCertSelParams_SetLeafCertFlag(
        PKIX_ComCertSelParams *params,
        PKIX_Boolean leafFlag,
        void *plContext);

#ifdef __cplusplus
}
#endif

#endif /* _PKIX_CERTSEL_H */