CA认证

开发平台：

WINDOWS

pkix.h：源码内容

* nssPKIXSubjectDirectoryAttributes_InsertAttribute
* nssPKIXSubjectDirectoryAttributes_AppendAttribute
* nssPKIXSubjectDirectoryAttributes_RemoveAttribute
* nssPKIXSubjectDirectoryAttributes_FindAttribute
* nssPKIXSubjectDirectoryAttributes_Equal
* nssPKIXSubjectDirectoryAttributes_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXSubjectDirectoryAttributes_verifyPointer
*
*/
/*
* nssPKIXSubjectDirectoryAttributes_Decode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_BER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXSubjectDirectoryAttributes upon
* success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXSubjectDirectoryAttributes *
nssPKIXSubjectDirectoryAttributes_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXSubjectDirectoryAttributes_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_ATTRIBUTE
*
* Return value:
* A valid pointer to an NSSPKIXSubjectDirectoryAttributes upon
* success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXSubjectDirectoryAttributes *
nssPKIXSubjectDirectoryAttributes_Create
(
NSSArena *arenaOpt,
NSSPKIXAttribute *attribute1,
...
);
/*
* nssPKIXSubjectDirectoryAttributes_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_DIRECTORY_ATTRIBUTES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXSubjectDirectoryAttributes_Destroy
(
NSSPKIXSubjectDirectoryAttributes *sda
);
/*
* nssPKIXSubjectDirectoryAttributes_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_DIRECTORY_ATTRIBUTES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXSubjectDirectoryAttributes_Encode
(
NSSPKIXSubjectDirectoryAttributes *sda,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXSubjectDirectoryAttributes_GetAttributeCount
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_DIRECTORY_ATTRIBUTES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXSubjectDirectoryAttributes_GetAttributeCount
(
NSSPKIXSubjectDirectoryAttributes *sda
);
/*
* nssPKIXSubjectDirectoryAttributes_GetAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_DIRECTORY_ATTRIBUTES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_ARRAY_TOO_SMALL
*
* Return value:
* A valid pointer to an array of NSSPKIXAttribute pointers upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAttribute **
nssPKIXSubjectDirectoryAttributes_GetAttributes
(
NSSPKIXSubjectDirectoryAttributes *sda,
NSSPKIXAttribute *rvOpt[],
PRInt32 limit,
NSSArena *arenaOpt
);
/*
* nssPKIXSubjectDirectoryAttributes_SetAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_DIRECTORY_ATTRIBUTES
* NSS_ERROR_INVALID_PKIX_ATTRIBUTE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXSubjectDirectoryAttributes_SetAttributes
(
NSSPKIXSubjectDirectoryAttributes *sda,
NSSAttribute *attributes[],
PRInt32 count
);
/*
* nssPKIXSubjectDirectoryAttributes_GetAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_DIRECTORY_ATTRIBUTES
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXAttribute upon success
* NULL upon error
*/
NSS_EXTERN NSSPKIXAttribute *
nssPKIXSubjectDirectoryAttributes_GetAttribute
(
NSSPKIXSubjectDirectoryAttributes *sda,
PRInt32 i,
NSSArena *arenaOpt
);
/*
* nssPKIXSubjectDirectoryAttributes_SetAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_DIRECTORY_ATTRIBUTES
* NSS_ERROR_INVALID_PKIX_ATTRIBUTE
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXSubjectDirectoryAttributes_SetAttribute
(
NSSPKIXSubjectDirectoryAttributes *sda,
PRInt32 i,
NSSPKIXAttribute *attribute
);
/*
* nssPKIXSubjectDirectoryAttributes_InsertAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_DIRECTORY_ATTRIBUTES
* NSS_ERROR_INVALID_PKIX_ATTRIBUTE
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXSubjectDirectoryAttributes_InsertAttribute
(
NSSPKIXSubjectDirectoryAttributes *sda,
PRInt32 i,
NSSPKIXAttribute *attribute
);
/*
* nssPKIXSubjectDirectoryAttributes_AppendAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_DIRECTORY_ATTRIBUTES
* NSS_ERROR_INVALID_PKIX_ATTRIBUTE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXSubjectDirectoryAttributes_AppendAttribute
(
NSSPKIXSubjectDirectoryAttributes *sda,
NSSPKIXAttribute *attribute
);
/*
* nssPKIXSubjectDirectoryAttributes_RemoveAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_DIRECTORY_ATTRIBUTES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXSubjectDirectoryAttributes_RemoveAttribute
(
NSSPKIXSubjectDirectoryAttributes *sda,
PRInt32 i
);
/*
* nssPKIXSubjectDirectoryAttributes_FindAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_DIRECTORY_ATTRIBUTES
* NSS_ERROR_INVALID_ATTRIBUTE
* NSS_ERROR_NOT_FOUND
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* The index of the specified policy mapping upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXSubjectDirectoryAttributes_FindAttribute
(
NSSPKIXSubjectDirectoryAttributes *sda,
NSSPKIXAttribute *attribute
);
/*
* nssPKIXSubjectDirectoryAttributes_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_DIRECTORY_ATTRIBUTES
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXSubjectDirectoryAttributes_Equal
(
NSSPKIXSubjectDirectoryAttributes *sda1,
NSSPKIXSubjectDirectoryAttributes *sda2,
PRStatus *statusOpt
);
/*
* nssPKIXSubjectDirectoryAttributes_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_DIRECTORY_ATTRIBUTES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXSubjectDirectoryAttributes upon
* success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXSubjectDirectoryAttributes *
nssPKIXSubjectDirectoryAttributes_Duplicate
(
NSSPKIXSubjectDirectoryAttributes *sda,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXSubjectDirectoryAttributes_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXSubjectDirectoryAttributes
* object, this routine will return PR_SUCCESS. Otherwise, it will
* put an error on the error stack and return PR_FAILURE.
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_DIRECTORY_ATTRIBUTES
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXSubjectDirectoryAttributes_verifyPointer
(
NSSPKIXSubjectDirectoryAttributes *p
);
#endif /* DEBUG */
/*
* BasicConstraints
*
* -- fgmr comments --
*
* From RFC 2459:
*
* BasicConstraints ::= SEQUENCE {
* cA BOOLEAN DEFAULT FALSE,
* pathLenConstraint INTEGER (0..MAX) OPTIONAL }
*
* The private calls for this type:
*
* nssPKIXBasicConstraints_Decode
* nssPKIXBasicConstraints_Create
* nssPKIXBasicConstraints_Destroy
* nssPKIXBasicConstraints_Encode
* nssPKIXBasicConstraints_GetCA
* nssPKIXBasicConstraints_SetCA
* nssPKIXBasicConstraints_HasPathLenConstraint
* nssPKIXBasicConstraints_GetPathLenConstraint
* nssPKIXBasicConstraints_SetPathLenConstraint
* nssPKIXBasicConstraints_RemovePathLenConstraint
* nssPKIXBasicConstraints_Equal
* nssPKIXBasicConstraints_Duplicate
* nssPKIXBasicConstraints_CompareToPathLenConstraint
*
* In debug builds, the following call is available:
*
* nssPKIXBasicConstraints_verifyPointer
*
*/
/*
* nssPKIXBasicConstraints_Decode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_BER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXBasicConstraints upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBasicConstraints *
nssPKIXBasicConstraints_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXBasicConstraints_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_VALUE
*
* Return value:
* A valid pointer to an NSSPKIXBasicConstraints upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBasicConstraints *
nssPKIXBasicConstraints_Create
(
NSSArena *arenaOpt,
PRBool ca,
PRInt32 pathLenConstraint
);
/*
* nssPKIXBasicConstraints_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BASIC_CONSTRAINTS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBasicConstraints_Destroy
(
NSSPKIXBasicConstraints *basicConstraints
);
/*
* nssPKIXBasicConstraints_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BASIC_CONSTRAINTS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXBasicConstraints_Encode
(
NSSPKIXBasicConstraints *basicConstraints,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXBasicConstraints_GetCA
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BASIC_CONSTRAINTS
*
* Return value:
* PR_TRUE if the CA bit is true
* PR_FALSE if it isn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXBasicConstraints_GetCA
(
NSSPKIXBasicConstraints *basicConstraints,
PRStatus *statusOpt
);
/*
* nssPKIXBasicConstraints_SetCA
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BASIC_CONSTRAINTS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBasicConstraints_SetCA
(
NSSPKIXBasicConstraints *basicConstraints,
PRBool ca
);
/*
* nssPKIXBasicConstraints_HasPathLenConstraint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BASIC_CONSTRAINTS
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXBasicConstraints_HasPathLenConstraint
(
NSSPKIXBasicConstraints *basicConstraints,
PRStatus *statusOpt
);
/*
* nssPKIXBasicConstraints_GetPathLenConstraint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BASIC_CONSTRAINTS
* NSS_ERROR_HAS_NO_PATH_LEN_CONSTRAINT
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXBasicConstraints_GetPathLenConstraint
(
NSSPKIXBasicConstraints *basicConstraints
);
/*
* nssPKIXBasicConstraints_SetPathLenConstraint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BASIC_CONSTRAINTS
* NSS_ERROR_INVALID_VALUE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBasicConstraints_SetPathLenConstraint
(
NSSPKIXBasicConstraints *basicConstraints,
PRInt32 pathLenConstraint
);
/*
* nssPKIXBasicConstraints_RemovePathLenConstraint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BASIC_CONSTRAINTS
* NSS_ERROR_HAS_NO_PATH_LEN_CONSTRAINT
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBasicConstraints_RemovePathLenConstraint
(
NSSPKIXBasicConstraints *basicConstraints
);
/*
* nssPKIXBasicConstraints_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BASIC_CONSTRAINTS
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXBasicConstraints_Equal
(
NSSPKIXBasicConstraints *basicConstraints1,
NSSPKIXBasicConstraints *basicConstraints2,
PRStatus *statusOpt
);
/*
* nssPKIXBasicConstraints_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BASIC_CONSTRAINTS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXBasicConstraints upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBasicConstraints *
nssPKIXBasicConstraints_Duplicate
(
NSSPKIXBasicConstraints *basicConstraints,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXBasicConstraints_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXBasicConstraints
* object, this routine will return PR_SUCCESS. Otherwise, it will
* put an error on the error stack and return PR_FAILURE.
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BASIC_CONSTRAINTS
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXBasicConstraints_verifyPointer
(
NSSPKIXBasicConstraints *p
);
#endif /* DEBUG */
/*
* nssPKIXBasicConstraints_CompareToPathLenConstraint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BASIC_CONSTRAINTS
* NSS_ERROR_HAS_NO_PATH_LEN_CONSTRAINT
*
* Return value:
* 1 if the specified value is greater than the pathLenConstraint
* 0 if the specified value equals the pathLenConstraint
* -1 if the specified value is less than the pathLenConstraint
* -2 upon error
*/
NSS_EXTERN PRInt32
nssPKIXBasicConstraints_CompareToPathLenConstraint
(
NSSPKIXBasicConstraints *basicConstraints,
PRInt32 value
);
/*
* NameConstraints
*
* -- fgmr comments --
*
* From RFC 2459:
*
* NameConstraints ::= SEQUENCE {
* permittedSubtrees [0] GeneralSubtrees OPTIONAL,
* excludedSubtrees [1] GeneralSubtrees OPTIONAL }
*
* The private calls for this type:
*
* nssPKIXNameConstraints_Decode
* nssPKIXNameConstraints_Create
* nssPKIXNameConstraints_Destroy
* nssPKIXNameConstraints_Encode
* nssPKIXNameConstraints_HasPermittedSubtrees
* nssPKIXNameConstraints_GetPermittedSubtrees
* nssPKIXNameConstraints_SetPermittedSubtrees
* nssPKIXNameConstraints_RemovePermittedSubtrees
* nssPKIXNameConstraints_HasExcludedSubtrees
* nssPKIXNameConstraints_GetExcludedSubtrees
* nssPKIXNameConstraints_SetExcludedSubtrees
* nssPKIXNameConstraints_RemoveExcludedSubtrees
* nssPKIXNameConstraints_Equal
* nssPKIXNameConstraints_Duplicate
* { and the comparator functions }
*
* In debug builds, the following call is available:
*
* nssPKIXNameConstraints_verifyPointer
*
*/
/*
* nssPKIXNameConstraints_Decode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_BER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXNameConstraints upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXNameConstraints *
nssPKIXNameConstraints_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXNameConstraints_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
*
* Return value:
* A valid pointer to an NSSPKIXNameConstraints upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXNameConstraints *
nssPKIXNameConstraints_Create
(
NSSArena *arenaOpt,
NSSPKIXGeneralSubtrees *permittedSubtrees,
NSSPKIXGeneralSubtrees *excludedSubtrees
);
/*
* nssPKIXNameConstraints_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_NAME_CONSTRAINTS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXNameConstraints_Destroy
(
NSSPKIXNameConstraints *nameConstraints
);
/*
* nssPKIXNameConstraints_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_NAME_CONSTRAINTS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXNameConstraints_Encode
(
NSSPKIXNameConstraints *nameConstraints,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXNameConstraints_HasPermittedSubtrees
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_NAME_CONSTRAINTS
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXNameConstraints_HasPermittedSubtrees
(
NSSPKIXNameConstraints *nameConstraints,
PRStatus *statusOpt
);
/*
* nssPKIXNameConstraints_GetPermittedSubtrees
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_NAME_CONSTRAINTS
* NSS_ERROR_HAS_NO_PERMITTED_SUBTREES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXGeneralSubtrees upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXGeneralSubtrees *
nssPKIXNameConstraints_GetPermittedSubtrees
(
NSSPKIXNameConstraints *nameConstraints,
NSSArena *arenaOpt
);
/*
* nssPKIXNameConstraints_SetPermittedSubtrees
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_NAME_CONSTRAINTS
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXNameConstraints_SetPermittedSubtrees
(
NSSPKIXNameConstraints *nameConstraints,
NSSPKIXGeneralSubtrees *permittedSubtrees
);
/*
* nssPKIXNameConstraints_RemovePermittedSubtrees
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_NAME_CONSTRAINTS
* NSS_ERROR_HAS_NO_PERMITTED_SUBTREES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXNameConstraints_RemovePermittedSubtrees
(
NSSPKIXNameConstraints *nameConstraints
);
/*
* nssPKIXNameConstraints_HasExcludedSubtrees
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_NAME_CONSTRAINTS
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXNameConstraints_HasExcludedSubtrees
(
NSSPKIXNameConstraints *nameConstraints,
PRStatus *statusOpt
);
/*
* nssPKIXNameConstraints_GetExcludedSubtrees
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_NAME_CONSTRAINTS
* NSS_ERROR_HAS_NO_EXCLUDED_SUBTREES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXGeneralSubtrees upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXGeneralSubtrees *
nssPKIXNameConstraints_GetExcludedSubtrees
(
NSSPKIXNameConstraints *nameConstraints,
NSSArena *arenaOpt
);
/*
* nssPKIXNameConstraints_SetExcludedSubtrees
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_NAME_CONSTRAINTS
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXNameConstraints_SetExcludedSubtrees
(
NSSPKIXNameConstraints *nameConstraints,
NSSPKIXGeneralSubtrees *excludedSubtrees
);
/*
* nssPKIXNameConstraints_RemoveExcludedSubtrees
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_NAME_CONSTRAINTS
* NSS_ERROR_HAS_NO_EXCLUDED_SUBTREES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXNameConstraints_RemoveExcludedSubtrees
(
NSSPKIXNameConstraints *nameConstraints
);
/*
* nssPKIXNameConstraints_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_NAME_CONSTRAINTS
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXNameConstraints_Equal
(
NSSPKIXNameConstraints *nameConstraints1,
NSSPKIXNameConstraints *nameConstraints2,
PRStatus *statusOpt
);
/*
* nssPKIXNameConstraints_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_NAME_CONSTRAINTS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXNameConstraints upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXNameConstraints *
nssPKIXNameConstraints_Duplicate
(
NSSPKIXNameConstraints *nameConstraints,
NSSArena *arenaOpt
);
/*
* { and the comparator functions }
*
*/
#ifdef DEBUG
/*
* nssPKIXNameConstraints_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXNameConstraints
* object, this routine will return PR_SUCCESS. Otherwise, it will
* put an error on the error stack and return PR_FAILURE.
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_NAME_CONSTRAINTS
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXNameConstraints_verifyPointer
(
NSSPKIXNameConstraints *p
);
#endif /* DEBUG */
/*
* GeneralSubtrees
*
* -- fgmr comments --
*
* From RFC 2459:
*
* GeneralSubtrees ::= SEQUENCE SIZE (1..MAX) OF GeneralSubtree
*
* The private calls for this type:
*
* nssPKIXGeneralSubtrees_Decode
* nssPKIXGeneralSubtrees_Create
* nssPKIXGeneralSubtrees_Destroy
* nssPKIXGeneralSubtrees_Encode
* nssPKIXGeneralSubtrees_GetGeneralSubtreeCount
* nssPKIXGeneralSubtrees_GetGeneralSubtrees
* nssPKIXGeneralSubtrees_SetGeneralSubtrees
* nssPKIXGeneralSubtrees_GetGeneralSubtree
* nssPKIXGeneralSubtrees_SetGeneralSubtree
* nssPKIXGeneralSubtrees_InsertGeneralSubtree
* nssPKIXGeneralSubtrees_AppendGeneralSubtree
* nssPKIXGeneralSubtrees_RemoveGeneralSubtree
* nssPKIXGeneralSubtrees_FindGeneralSubtree
* nssPKIXGeneralSubtrees_Equal
* nssPKIXGeneralSubtrees_Duplicate
* { and finders and comparators }
*
* In debug builds, the following call is available:
*
* nssPKIXGeneralSubtrees_verifyPointer
*
*/
/*
* nssPKIXGeneralSubtrees_Decode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_BER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXGeneralSubtrees upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXGeneralSubtrees *
nssPKIXGeneralSubtrees_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXGeneralSubtrees_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
*
* Return value:
* A valid pointer to an NSSPKIXGeneralSubtrees upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXGeneralSubtrees *
nssPKIXGeneralSubtrees_Create
(
NSSArena *arenaOpt,
NSSPKIXGeneralSubtree *generalSubtree1,
...
);
/*
* nssPKIXGeneralSubtrees_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXGeneralSubtrees_Destroy
(
NSSPKIXGeneralSubtrees *generalSubtrees
);
/*
* nssPKIXGeneralSubtrees_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXGeneralSubtrees_Encode
(
NSSPKIXGeneralSubtrees *generalSubtrees,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXGeneralSubtrees_GetGeneralSubtreeCount
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXGeneralSubtrees_GetGeneralSubtreeCount
(
NSSPKIXGeneralSubtrees *generalSubtrees
);
/*
* nssPKIXGeneralSubtrees_GetGeneralSubtrees
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_ARRAY_TOO_SMALL
*
* Return value:
* A valid pointer to an array of NSSPKIXGeneralSubtree pointers upon
* success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXGeneralSubtree **
nssPKIXGeneralSubtrees_GetGeneralSubtrees
(
NSSPKIXGeneralSubtrees *generalSubtrees,
NSSPKIXGeneralSubtree *rvOpt[],
PRInt32 limit,
NSSArena *arenaOpt
);
/*
* nssPKIXGeneralSubtrees_SetGeneralSubtrees
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXGeneralSubtrees_SetGeneralSubtrees
(
NSSPKIXGeneralSubtrees *generalSubtrees,
NSSPKIXGeneralSubtree *generalSubtree[],
PRInt32 count
);
/*
* nssPKIXGeneralSubtrees_GetGeneralSubtree
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXGeneralSubtree upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXGeneralSubtree *
nssPKIXGeneralSubtrees_GetGeneralSubtree
(
NSSPKIXGeneralSubtrees *generalSubtrees,
PRInt32 i,
NSSArena *arenaOpt
);
/*
* nssPKIXGeneralSubtrees_SetGeneralSubtree
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXGeneralSubtrees_SetGeneralSubtree
(
NSSPKIXGeneralSubtrees *generalSubtrees,
PRInt32 i,
NSSPKIXGeneralSubtree *generalSubtree
);
/*
* nssPKIXGeneralSubtrees_InsertGeneralSubtree
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXGeneralSubtrees_InsertGeneralSubtree
(
NSSPKIXGeneralSubtrees *generalSubtrees,
PRInt32 i,
NSSPKIXGeneralSubtree *generalSubtree
);
/*
* nssPKIXGeneralSubtrees_AppendGeneralSubtree
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXGeneralSubtrees_AppendGeneralSubtree
(
NSSPKIXGeneralSubtrees *generalSubtrees,
NSSPKIXGeneralSubtree *generalSubtree
);
/*
* nssPKIXGeneralSubtrees_RemoveGeneralSubtree
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXGeneralSubtrees_RemoveGeneralSubtree
(
NSSPKIXGeneralSubtrees *generalSubtrees,
PRInt32 i
);
/*
* nssPKIXGeneralSubtrees_FindGeneralSubtree
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
* NSS_ERROR_NOT_FOUND
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* The index of the specified policy mapping upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXGeneralSubtrees_FindGeneralSubtree
(
NSSPKIXGeneralSubtrees *generalSubtrees,
NSSPKIXGeneralSubtree *generalSubtree
);
/*
* nssPKIXGeneralSubtrees_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXGeneralSubtrees_Equal
(
NSSPKIXGeneralSubtrees *generalSubtrees1,
NSSPKIXGeneralSubtrees *generalSubtrees2,
PRStatus *statusOpt
);
/*
* nssPKIXGeneralSubtrees_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXGeneralSubtrees upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXGeneralSubtrees *
nssPKIXGeneralSubtrees_Duplicate
(
NSSPKIXGeneralSubtrees *generalSubtrees,
NSSArena *arenaOpt
);
/*
* { and finders and comparators }
*
*/
#ifdef DEBUG
/*
* nssPKIXGeneralSubtrees_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXGeneralSubtrees
* object, this routine will return PR_SUCCESS. Otherwise, it will
* put an error on the error stack and return PR_FAILURE.
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREES
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXGeneralSubtrees_verifyPointer
(
NSSPKIXGeneralSubtrees *p
);
#endif /* DEBUG */
/*
* GeneralSubtree
*
* -- fgmr comments --
*
* From RFC 2459:
*
* GeneralSubtree ::= SEQUENCE {
* base GeneralName,
* minimum [0] BaseDistance DEFAULT 0,
* maximum [1] BaseDistance OPTIONAL }
*
* The private calls for this type:
*
* nssPKIXGeneralSubtree_Decode
* nssPKIXGeneralSubtree_Create
* nssPKIXGeneralSubtree_Destroy
* nssPKIXGeneralSubtree_Encode
* nssPKIXGeneralSubtree_GetBase
* nssPKIXGeneralSubtree_SetBase
* nssPKIXGeneralSubtree_GetMinimum
* nssPKIXGeneralSubtree_SetMinimum
* nssPKIXGeneralSubtree_HasMaximum
* nssPKIXGeneralSubtree_GetMaximum
* nssPKIXGeneralSubtree_SetMaximum
* nssPKIXGeneralSubtree_RemoveMaximum
* nssPKIXGeneralSubtree_Equal
* nssPKIXGeneralSubtree_Duplicate
* nssPKIXGeneralSubtree_DistanceInRange
* {other tests and comparators}
*
* In debug builds, the following call is available:
*
* nssPKIXGeneralSubtree_verifyPointer
*
*/
/*
* nssPKIXGeneralSubtree_Decode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_BER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXGeneralSubtree upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXGeneralSubtree *
nssPKIXGeneralSubtree_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXGeneralSubtree_Create
*
* -- fgmr comments --
* The optional maximum value may be omitted by specifying -1.
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_GENERAL_NAME
* NSS_ERROR_INVALID_VALUE
*
* Return value:
* A valid pointer to an NSSPKIXGeneralSubtree upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXGeneralSubtree *
nssPKIXGeneralSubtree_Create
(
NSSArena *arenaOpt,
NSSPKIXBaseDistance minimum,
NSSPKIXBaseDistance maximumOpt
);
/*
* nssPKIXGeneralSubtree_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXGeneralSubtree_Destroy
(
NSSPKIXGeneralSubtree *generalSubtree
);
/*
* nssPKIXGeneralSubtree_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXGeneralSubtree_Encode
(
NSSPKIXGeneralSubtree *generalSubtree,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXGeneralSubtree_GetBase
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXGeneralName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXGeneralName *
nssPKIXGeneralSubtree_GetBase
(
NSSPKIXGeneralSubtree *generalSubtree,
NSSArena *arenaOpt
);
/*
* nssPKIXGeneralSubtree_SetBase
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
* NSS_ERROR_INVALID_PKIX_GENERAL_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXGeneralSubtree_SetBase
(
NSSPKIXGeneralSubtree *generalSubtree,
NSSPKIXGeneralName *base
);
/*
* nssPKIXGeneralSubtree_GetMinimum
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN NSSPKIXBaseDistance
nssPKIXGeneralSubtree_GetMinimum
(
NSSPKIXGeneralSubtree *generalSubtree
);
/*
* nssPKIXGeneralSubtree_SetMinimum
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
* NSS_ERROR_INVALID_VALUE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXGeneralSubtree_SetMinimum
(
NSSPKIXGeneralSubtree *generalSubtree,
NSSPKIXBaseDistance *minimum
);
/*
* nssPKIXGeneralSubtree_HasMaximum
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXGeneralSubtree_HasMaximum
(
NSSPKIXGeneralSubtree *generalSubtree
);
/*
* nssPKIXGeneralSubtree_GetMaximum
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
* NSS_ERROR_HAS_NO_MAXIMUM_BASE_DISTANCE
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN NSSPKIXBaseDistance
nssPKIXGeneralSubtree_GetMaximum
(
NSSPKIXGeneralSubtree *generalSubtree
);
/*
* nssPKIXGeneralSubtree_SetMaximum
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
* NSS_ERROR_INVALID_VALUE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXGeneralSubtree_SetMaximum
(
NSSPKIXGeneralSubtree *generalSubtree,
NSSPKIXBaseDistance *maximum
);
/*
* nssPKIXGeneralSubtree_RemoveMaximum
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
* NSS_ERROR_HAS_NO_MAXIMUM_BASE_DISTANCE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXGeneralSubtree_RemoveMaximum
(
NSSPKIXGeneralSubtree *generalSubtree
);
/*
* nssPKIXGeneralSubtree_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXGeneralSubtree_Equal
(
NSSPKIXGeneralSubtree *generalSubtree1,
NSSPKIXGeneralSubtree *generalSubtree2,
PRStatus *statusOpt
);
/*
* nssPKIXGeneralSubtree_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXGeneralSubtree upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXGeneralSubtree *
nssPKIXGeneralSubtree_Duplicate
(
NSSPKIXGeneralSubtree *generalSubtree,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXGeneralSubtree_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXGeneralSubtree
* object, this routine will return PR_SUCCESS. Otherwise, it will
* put an error on the error stack and return PR_FAILURE.
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXGeneralSubtree_verifyPointer
(
NSSPKIXGeneralSubtree *p
);
#endif /* DEBUG */
/*
* nssPKIXGeneralSubtree_DistanceInRange
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_GENERAL_SUBTREE
* NSS_ERROR_INVALID_VALUE
*
* Return value:
* PR_TRUE if the specified value is within the minimum and maximum
* base distances
* PR_FALSE if it isn't
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXGeneralSubtree_DistanceInRange
(
NSSPKIXGeneralSubtree *generalSubtree,
NSSPKIXBaseDistance value,
PRStatus *statusOpt
);
/*
* {other tests and comparators}
*
*/
/*
* PolicyConstraints
*
* -- fgmr comments --
*
* From RFC 2459:
*
* PolicyConstraints ::= SEQUENCE {
* requireExplicitPolicy [0] SkipCerts OPTIONAL,
* inhibitPolicyMapping [1] SkipCerts OPTIONAL }
*
* The private calls for this type:
*
* nssPKIXPolicyConstraints_Decode
* nssPKIXPolicyConstraints_Create
* nssPKIXPolicyConstraints_Destroy
* nssPKIXPolicyConstraints_Encode
* nssPKIXPolicyConstraints_HasRequireExplicitPolicy
* nssPKIXPolicyConstraints_GetRequireExplicitPolicy
* nssPKIXPolicyConstraints_SetRequireExplicitPolicy
* nssPKIXPolicyConstraints_RemoveRequireExplicitPolicy
* nssPKIXPolicyConstraints_HasInhibitPolicyMapping
* nssPKIXPolicyConstraints_GetInhibitPolicyMapping
* nssPKIXPolicyConstraints_SetInhibitPolicyMapping
* nssPKIXPolicyConstraints_RemoveInhibitPolicyMapping
* nssPKIXPolicyConstraints_Equal
* nssPKIXPolicyConstraints_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXPolicyConstraints_verifyPointer
*
*/
/*
* nssPKIXPolicyConstraints_Decode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_BER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXPolicyConstraints upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPolicyConstraints *
nssPKIXPolicyConstraints_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXPolicyConstraints_Create
*
* -- fgmr comments --
* The optional values may be omitted by specifying -1.
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_VALUE
*
* Return value:
* A valid pointer to an NSSPKIXPolicyConstraints upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPolicyConstraints *
nssPKIXPolicyConstraints_Create
(
NSSArena *arenaOpt,
NSSPKIXSkipCerts requireExplicitPolicy,
NSSPKIXSkipCerts inhibitPolicyMapping
);
/*
* nssPKIXPolicyConstraints_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_POLICY_CONSTRAINTS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPolicyConstraints_Destroy
(
NSSPKIXPolicyConstraints *policyConstraints
);
/*
* nssPKIXPolicyConstraints_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_POLICY_CONSTRAINTS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXPolicyConstraints_Encode
(
NSSPKIXPolicyConstraints *policyConstraints,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXPolicyConstraints_HasRequireExplicitPolicy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_POLICY_CONSTRAINTS
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXPolicyConstraints_HasRequireExplicitPolicy
(
NSSPKIXPolicyConstraints *policyConstraints
);
/*
* nssPKIXPolicyConstraints_GetRequireExplicitPolicy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_POLICY_CONSTRAINTS
* NSS_ERROR_HAS_NO_REQUIRE_EXPLICIT_POLICY
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXPolicyConstraints_GetRequireExplicitPolicy
(
NSSPKIXPolicyConstraints *policyConstraints
);
/*
* nssPKIXPolicyConstraints_SetRequireExplicitPolicy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_POLICY_CONSTRAINTS
* NSS_ERROR_INVALID_VALUE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPolicyConstraints_SetRequireExplicitPolicy
(
NSSPKIXPolicyConstraints *policyConstraints,
NSSPKIXSkipCerts requireExplicitPolicy
);
/*
* nssPKIXPolicyConstraints_RemoveRequireExplicitPolicy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_POLICY_CONSTRAINTS
* NSS_ERROR_HAS_NO_REQUIRE_EXPLICIT_POLICY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPolicyConstraints_RemoveRequireExplicitPolicy
(
NSSPKIXPolicyConstraints *policyConstraints
);
/*
* nssPKIXPolicyConstraints_HasInhibitPolicyMapping
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_POLICY_CONSTRAINTS
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXPolicyConstraints_HasInhibitPolicyMapping
(
NSSPKIXPolicyConstraints *policyConstraints
);
/*
* nssPKIXPolicyConstraints_GetInhibitPolicyMapping
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_POLICY_CONSTRAINTS
* NSS_ERROR_HAS_NO_INHIBIT_POLICY_MAPPING
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXPolicyConstraints_GetInhibitPolicyMapping
(
NSSPKIXPolicyConstraints *policyConstraints
);
/*
* nssPKIXPolicyConstraints_SetInhibitPolicyMapping
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_POLICY_CONSTRAINTS
* NSS_ERROR_INVALID_VALUE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPolicyConstraints_SetInhibitPolicyMapping
(
NSSPKIXPolicyConstraints *policyConstraints,
NSSPKIXSkipCerts inhibitPolicyMapping
);
/*
* nssPKIXPolicyConstraints_RemoveInhibitPolicyMapping
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_POLICY_CONSTRAINTS
* NSS_ERROR_HAS_NO_INHIBIT_POLICY_MAPPING
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPolicyConstraints_RemoveInhibitPolicyMapping
(
NSSPKIXPolicyConstraints *policyConstraints
);
/*
* nssPKIXPolicyConstraints_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_POLICY_CONSTRAINTS
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXPolicyConstraints_Equal
(
NSSPKIXPolicyConstraints *policyConstraints1,
NSSPKIXPolicyConstraints *policyConstraints2,
PRStatus *statusOpt
);
/*
* nssPKIXPolicyConstraints_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_POLICY_CONSTRAINTS
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXPolicyConstraints upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPolicyConstraints *
nssPKIXPolicyConstraints_Duplicate
(
NSSPKIXPolicyConstraints *policyConstraints,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXPolicyConstraints_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXPolicyConstraints
* object, this routine will return PR_SUCCESS. Otherwise, it will
* put an error on the error stack and return PR_FAILURE.
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_POLICY_CONSTRAINTS
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXPolicyConstraints_verifyPointer
(
NSSPKIXPolicyConstraints *p
);
#endif /* DEBUG */
/*
* CRLDistPointsSyntax
*
* -- fgmr comments --
*
* From RFC 2459:
*
* CRLDistPointsSyntax ::= SEQUENCE SIZE (1..MAX) OF DistributionPoint
*
* The private calls for this type:
*
* nssPKIXCRLDistPointsSyntax_Decode
* nssPKIXCRLDistPointsSyntax_Create
* nssPKIXCRLDistPointsSyntax_Destroy
* nssPKIXCRLDistPointsSyntax_Encode
* nssPKIXCRLDistPointsSyntax_GetDistributionPointCount
* nssPKIXCRLDistPointsSyntax_GetDistributionPoints
* nssPKIXCRLDistPointsSyntax_SetDistributionPoints
* nssPKIXCRLDistPointsSyntax_GetDistributionPoint
* nssPKIXCRLDistPointsSyntax_SetDistributionPoint
* nssPKIXCRLDistPointsSyntax_InsertDistributionPoint
* nssPKIXCRLDistPointsSyntax_AppendDistributionPoint
* nssPKIXCRLDistPointsSyntax_RemoveDistributionPoint
* nssPKIXCRLDistPointsSyntax_FindDistributionPoint
* nssPKIXCRLDistPointsSyntax_Equal
* nssPKIXCRLDistPointsSyntax_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXCRLDistPointsSyntax_verifyPointer
*
*/
/*
* nssPKIXCRLDistPointsSyntax_Decode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_BER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXCRLDistPointsSyntax upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXCRLDistPointsSyntax *
nssPKIXCRLDistPointsSyntax_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXCRLDistPointsSyntax_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
*
* Return value:
* A valid pointer to an NSSPKIXCRLDistPointsSyntax upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXCRLDistPointsSyntax *
nssPKIXCRLDistPointsSyntax_Create
(
NSSArena *arenaOpt,
NSSPKIXDistributionPoint *distributionPoint1,
...
);
/*
* nssPKIXCRLDistPointsSyntax_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CRL_DIST_POINTS_SYNTAX
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXCRLDistPointsSyntax_Destroy
(
NSSPKIXCRLDistPointsSyntax *crlDistPointsSyntax
);
/*
* nssPKIXCRLDistPointsSyntax_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CRL_DIST_POINTS_SYNTAX
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXCRLDistPointsSyntax_Encode
(
NSSPKIXCRLDistPointsSyntax *crlDistPointsSyntax,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXCRLDistPointsSyntax_GetDistributionPointCount
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CRL_DIST_POINTS_SYNTAX
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXCRLDistPointsSyntax_GetDistributionPointCount
(
NSSPKIXCRLDistPointsSyntax *crlDistPointsSyntax
);
/*
* nssPKIXCRLDistPointsSyntax_GetDistributionPoints
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CRL_DIST_POINTS_SYNTAX
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_ARRAY_TOO_SMALL
*
* Return value:
* A valid pointer to an array of NSSPKIXDistributionPoint pointers
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXDistributionPoints **
nssPKIXCRLDistPointsSyntax_GetDistributionPoints
(
NSSPKIXCRLDistPointsSyntax *crlDistPointsSyntax,
NSSDistributionPoint *rvOpt[],
PRInt32 limit,
NSSArena *arenaOpt
);
/*
* nssPKIXCRLDistPointsSyntax_SetDistributionPoints
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CRL_DIST_POINTS_SYNTAX
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXCRLDistPointsSyntax_SetDistributionPoints
(
NSSPKIXCRLDistPointsSyntax *crlDistPointsSyntax,
NSSDistributionPoint *distributionPoint[]
PRInt32 count
);
/*
* nssPKIXCRLDistPointsSyntax_GetDistributionPoint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CRL_DIST_POINTS_SYNTAX
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXDistributionPoint upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXDistributionPoint *
nssPKIXCRLDistPointsSyntax_GetDistributionPoint
(
NSSPKIXCRLDistPointsSyntax *crlDistPointsSyntax,
NSSArena *arenaOpt
);
/*
* nssPKIXCRLDistPointsSyntax_SetDistributionPoint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CRL_DIST_POINTS_SYNTAX
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXCRLDistPointsSyntax_SetDistributionPoint
(
NSSPKIXCRLDistPointsSyntax *crlDistPointsSyntax,
PRInt32 i,
NSSPKIXDistributionPoint *distributionPoint
);
/*
* nssPKIXCRLDistPointsSyntax_InsertDistributionPoint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CRL_DIST_POINTS_SYNTAX
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXCRLDistPointsSyntax_InsertDistributionPoint
(
NSSPKIXCRLDistPointsSyntax *crlDistPointsSyntax,
PRInt32 i,
NSSPKIXDistributionPoint *distributionPoint
);
/*
* nssPKIXCRLDistPointsSyntax_AppendDistributionPoint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CRL_DIST_POINTS_SYNTAX
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXCRLDistPointsSyntax_AppendDistributionPoint
(
NSSPKIXCRLDistPointsSyntax *crlDistPointsSyntax,
NSSPKIXDistributionPoint *distributionPoint
);
/*
* nssPKIXCRLDistPointsSyntax_RemoveDistributionPoint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CRL_DIST_POINTS_SYNTAX
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXCRLDistPointsSyntax_RemoveDistributionPoint
(
NSSPKIXCRLDistPointsSyntax *crlDistPointsSyntax,
PRInt32 i
);
/*
* nssPKIXCRLDistPointsSyntax_FindDistributionPoint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CRL_DIST_POINTS_SYNTAX
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
* NSS_ERROR_NOT_FOUND
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* The index of the specified policy mapping upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXCRLDistPointsSyntax_FindDistributionPoint
(
NSSPKIXCRLDistPointsSyntax *crlDistPointsSyntax,
NSSPKIXDistributionPoint *distributionPoint
);
/*
* nssPKIXCRLDistPointsSyntax_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CRL_DIST_POINTS_SYNTAX
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXCRLDistPointsSyntax_Equal
(
NSSPKIXCRLDistPointsSyntax *crlDistPointsSyntax1,
NSSPKIXCRLDistPointsSyntax *crlDistPointsSyntax2,
PRStatus *statusOpt
);
/*
* nssPKIXCRLDistPointsSyntax_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CRL_DIST_POINTS_SYNTAX
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXCRLDistPointsSyntax upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXCRLDistPointsSyntax *
nssPKIXCRLDistPointsSyntax_Duplicate
(
NSSPKIXCRLDistPointsSyntax *crlDistPointsSyntax,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXCRLDistPointsSyntax_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXCRLDistPointsSyntax
* object, this routine will return PR_SUCCESS. Otherwise, it will
* put an error on the error stack and return PR_FAILURE.
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CRL_DIST_POINTS_SYNTAX
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXCRLDistPointsSyntax_verifyPointer
(
NSSPKIXCRLDistPointsSyntax *p
);
#endif /* DEBUG */
/*
* DistributionPoint
*
* -- fgmr comments --
*
* From RFC 2459:
*
* DistributionPoint ::= SEQUENCE {
* distributionPoint [0] DistributionPointName OPTIONAL,
* reasons [1] ReasonFlags OPTIONAL,
* cRLIssuer [2] GeneralNames OPTIONAL }
*
* The private calls for this type:
*
* nssPKIXDistributionPoint_Decode
* nssPKIXDistributionPoint_Create
* nssPKIXDistributionPoint_Destroy
* nssPKIXDistributionPoint_Encode
* nssPKIXDistributionPoint_HasDistributionPoint
* nssPKIXDistributionPoint_GetDistributionPoint
* nssPKIXDistributionPoint_SetDistributionPoint
* nssPKIXDistributionPoint_RemoveDistributionPoint
* nssPKIXDistributionPoint_HasReasons
* nssPKIXDistributionPoint_GetReasons
* nssPKIXDistributionPoint_SetReasons
* nssPKIXDistributionPoint_RemoveReasons
* nssPKIXDistributionPoint_HasCRLIssuer
* nssPKIXDistributionPoint_GetCRLIssuer
* nssPKIXDistributionPoint_SetCRLIssuer
* nssPKIXDistributionPoint_RemoveCRLIssuer
* nssPKIXDistributionPoint_Equal
* nssPKIXDistributionPoint_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXDistributionPoint_verifyPointer
*
*/
/*
* nssPKIXDistributionPoint_Decode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_BER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXDistributionPoint upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXDistributionPoint *
nssPKIXDistributionPoint_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXDistributionPoint_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT_NAME
* NSS_ERROR_INVALID_PKIX_REASON_FLAGS
* NSS_ERROR_INVALID_PKIX_GENERAL_NAMES
*
* Return value:
* A valid pointer to an NSSPKIXDistributionPoint upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXDistributionPoint *
nssPKIXDistributionPoint_Create
(
NSSArena *arenaOpt,
NSSPKIXDistributionPointName *distributionPoint,
NSSPKIXReasonFlags reasons,
NSSPKIXGeneralNames *cRLIssuer
);
/*
* nssPKIXDistributionPoint_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXDistributionPoint_Destroy
(
NSSPKIXDistributionPoint *distributionPoint
);
/*
* nssPKIXDistributionPoint_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXDistributionPoint_Encode
(
NSSPKIXDistributionPoint *distributionPoint,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXDistributionPoint_HasDistributionPoint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXDistributionPoint_HasDistributionPoint
(
NSSPKIXDistributionPoint *distributionPoint
);
/*
* nssPKIXDistributionPoint_GetDistributionPoint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
* NSS_ERROR_HAS_NO_DISTRIBUTION_POINT
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXDistributionPointName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXDistributionPointName *
nssPKIXDistributionPoint_GetDistributionPoint
(
NSSPKIXDistributionPoint *distributionPoint,
NSSArena *arenaOpt
);
/*
* nssPKIXDistributionPoint_SetDistributionPoint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXDistributionPoint_SetDistributionPoint
(
NSSPKIXDistributionPoint *distributionPoint,
NSSPKIXDistributionPointName *name
);
/*
* nssPKIXDistributionPoint_RemoveDistributionPoint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
* NSS_ERROR_HAS_NO_DISTRIBUTION_POINT
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXDistributionPoint_RemoveDistributionPoint
(
NSSPKIXDistributionPoint *distributionPoint
);
/*
* nssPKIXDistributionPoint_HasReasons
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXDistributionPoint_HasReasons
(
NSSPKIXDistributionPoint *distributionPoint
);
/*
* nssPKIXDistributionPoint_GetReasons
*
* It is unlikely that the reason flags are all zero; so zero is
* returned in error situations.
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
* NSS_ERROR_HAS_NO_REASONS
*
* Return value:
* A valid nonzero NSSPKIXReasonFlags value upon success
* A valid zero NSSPKIXReasonFlags if the value is indeed zero
* Zero upon error
*/
NSS_EXTERN NSSPKIXReasonFlags
nssPKIXDistributionPoint_GetReasons
(
NSSPKIXDistributionPoint *distributionPoint,
PRStatus *statusOpt
);
/*
* nssPKIXDistributionPoint_SetReasons
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
* NSS_ERROR_INVALID_PKIX_REASON_FLAGS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXDistributionPoint_SetReasons
(
NSSPKIXDistributionPoint *distributionPoint,
NSSPKIXReasonFlags reasons
);
/*
* nssPKIXDistributionPoint_RemoveReasons
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
* NSS_ERROR_HAS_NO_REASONS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXDistributionPoint_RemoveReasons
(
NSSPKIXDistributionPoint *distributionPoint
);
/*
* nssPKIXDistributionPoint_HasCRLIssuer
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXDistributionPoint_HasCRLIssuer
(
NSSPKIXDistributionPoint *distributionPoint
);
/*
* nssPKIXDistributionPoint_GetCRLIssuer
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
* NSS_ERROR_HAS_NO_CRL_ISSUER
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXGeneralNames upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXGeneralNames *
nssPKIXDistributionPoint_GetCRLIssuer
(
NSSPKIXDistributionPoint *distributionPoint,
NSSArena *arenaOpt
);
/*
* nssPKIXDistributionPoint_SetCRLIssuer
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
* NSS_ERROR_INVALID_PKIX_GENERAL_NAMES
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXDistributionPoint_SetCRLIssuer
(
NSSPKIXDistributionPoint *distributionPoint,
NSSPKIXGeneralNames *cRLIssuer
);
/*
* nssPKIXDistributionPoint_RemoveCRLIssuer
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
* NSS_ERROR_HAS_NO_CRL_ISSUER
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXDistributionPoint_RemoveCRLIssuer
(
NSSPKIXDistributionPoint *distributionPoint
);
/*
* nssPKIXDistributionPoint_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXDistributionPoint_Equal
(
NSSPKIXDistributionPoint *distributionPoint1,
NSSPKIXDistributionPoint *distributionPoint2,
PRStatus *statusOpt
);
/*
* nssPKIXDistributionPoint_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
*
* Return value:
* A valid pointer to an NSSPKIXDistributionPoint upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXDistributionPoint *
nssPKIXDistributionPoint_Duplicate
(
NSSPKIXDistributionPoint *distributionPoint,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXDistributionPoint_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXDistributionPoint
* object, this routine will return PR_SUCCESS. Otherwise, it will
* put an error on the error stack and return PR_FAILURE.
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXDistributionPoint_verifyPointer
(
NSSPKIXDistributionPoint *p
);
#endif /* DEBUG */
/*
* DistributionPointName
*
* -- fgmr comments --
*
* From RFC 2459:
*
* DistributionPointName ::= CHOICE {
* fullName [0] GeneralNames,
* nameRelativeToCRLIssuer [1] RelativeDistinguishedName }
*
* The private calls for this type:
*
* nssPKIXDistributionPointName_Decode
* nssPKIXDistributionPointName_Create
* nssPKIXDistributionPointName_CreateFromFullName
* nssPKIXDistributionPointName_CreateFromNameRelativeToCRLIssuer
* nssPKIXDistributionPointName_Destroy
* nssPKIXDistributionPointName_Encode
* nssPKIXDistributionPointName_GetChoice
* nssPKIXDistributionPointName_GetFullName
* nssPKIXDistributionPointName_GetNameRelativeToCRLIssuer
* nssPKIXDistributionPointName_Equal
* nssPKIXDistributionPointName_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXDistributionPointName_verifyPointer
*
*/
/*
* nssPKIXDistributionPointName_Decode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_BER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXDistributionPointName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXDistributionPointName *
nssPKIXDistributionPointName_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXDistributionPointName_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT_NAME_CHOICE
* NSS_ERROR_INVALID_PKIX_GENERAL_NAMES
* NSS_ERROR_INVALID_PKIX_RELATIVE_DISTINGUISHED_NAME
*
* Return value:
* A valid pointer to an NSSPKIXDistributionPointName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXDistributionPointName *
nssPKIXDistributionPointName_Create
(
NSSArena *arenaOpt,
NSSPKIXDistributionPointNameChoice which,
void *name
);
/*
* nssPKIXDistributionPointName_CreateFromFullName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_GENERAL_NAMES
*
* Return value:
* A valid pointer to an NSSPKIXDistributionPointName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXDistributionPointName *
nssPKIXDistributionPointName_CreateFromFullName
(
NSSArena *arenaOpt,
NSSPKIXGeneralNames *fullName
);
/*
* nssPKIXDistributionPointName_CreateFromNameRelativeToCRLIssuer
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_RELATIVE_DISTINGUISHED_NAME
*
* Return value:
* A valid pointer to an NSSPKIXDistributionPointName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXDistributionPointName *
nssPKIXDistributionPointName_CreateFromNameRelativeToCRLIssuer
(
NSSArena *arenaOpt,
NSSPKIXRelativeDistinguishedName *nameRelativeToCRLIssuer
);
/*
* nssPKIXDistributionPointName_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXDistributionPointName_Destroy
(
NSSPKIXDistributionPointName *dpn
);
/*
* nssPKIXDistributionPointName_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT_NAME
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXDistributionPointName_Encode
(
NSSPKIXDistributionPointName *dpn,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXDistributionPointName_GetChoice
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT_NAME
*
* Return value:
* A valid NSSPKIXDistributionPointNameChoice value upon success
* NSSPKIXDistributionPointNameChoice_NSSinvalid upon failure
*/
NSS_EXTERN NSSPKIXDistributionPointNameChoice
nssPKIXDistributionPointName_GetChoice
(
NSSPKIXDistributionPointName *dpn
);
/*
* nssPKIXDistributionPointName_GetFullName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT_NAME
* NSS_ERROR_WRONG_CHOICE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXGeneralNames upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXGeneralnames *
nssPKIXDistributionPointName_GetFullName
(
NSSPKIXDistributionPointName *dpn,
NSSArena *arenaOpt
);
/*
* nssPKIXDistributionPointName_GetNameRelativeToCRLIssuer
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT_NAME
* NSS_ERROR_WRONG_CHOICE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXRelativeDistinguishedName upon
* success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXRelativeDistinguishedName *
nssPKIXDistributionPointName_GetNameRelativeToCRLIssuer
(
NSSPKIXDistributionPointName *dpn,
NSSArena *arenaOpt
);
/*
* nssPKIXDistributionPointName_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT_NAME
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXDistributionPointName_Equal
(
NSSPKIXDistributionPointName *dpn1,
NSSPKIXDistributionPointName *dpn2,
PRStatus *statusOpt
);
/*
* nssPKIXDistributionPointName_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT_NAME
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXDistributionPointName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXDistributionPointName *
nssPKIXDistributionPointName_Duplicate
(
NSSPKIXDistributionPointName *dpn,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXDistributionPointName_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXDistributionPointName
* object, this routine will return PR_SUCCESS. Otherwise, it will
* put an error on the error stack and return PR_FAILURE.
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT_NAME
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXDistributionPointName_verifyPointer
(
NSSPKIXDistributionPointName *p
);
#endif /* DEBUG */
/*
* ReasonFlags
*
* -- fgmr comments --
*
* From RFC 2459:
*
* ReasonFlags ::= BIT STRING {
* unused (0),
* keyCompromise (1),
* cACompromise (2),
* affiliationChanged (3),
* superseded (4),
* cessationOfOperation (5),
* certificateHold (6) }
*
* The private calls for this type:
*
* nssPKIXReasonFlags_Decode
* nssPKIXReasonFlags_Create
* nssPKIXReasonFlags_CreateFromMask
* nssPKIXReasonFlags_Destroy
* nssPKIXReasonFlags_Encode
* nssPKIXReasonFlags_GetMask
* nssPKIXReasonFlags_SetMask
* nssPKIXReasonFlags_Equal
* nssPKIXReasonFlags_Duplicate
* { bitwise accessors? }
*
* In debug builds, the following call is available:
*
* nssPKIXReasonFlags_verifyPointer
*
*/
/*
* nssPKIXReasonFlags_Decode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_BER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXReasonFlags upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXReasonFlags *
nssPKIXReasonFlags_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXReasonFlags_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXReasonFlags upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXReasonFlags *
nssPKIXReasonFlags_Create
(
NSSArena *arenaOpt,
PRBool keyCompromise,
PRBool cACompromise,
PRBool affiliationChanged,
PRBool superseded,
PRBool cessationOfOperation,
PRBool certificateHold
);
/*
* nssPKIXReasonFlags_CreateFromMask
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_REASON_FLAGS_MASK
*
* Return value:
* A valid pointer to an NSSPKIXReasonFlags upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXReasonFlags *
nssPKIXReasonFlags_CreateFromMask
(
NSSArena *arenaOpt,
NSSPKIXReasonFlagsMask why
);
/*
* nssPKIXReasonFlags_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REASON_FLAGS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXReasonFlags_Destroy
(
NSSPKIXReasonFlags *reasonFlags
);
/*
* nssPKIXReasonFlags_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REASON_FLAGS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXReasonFlags_Encode
(
NSSPKIXReasonFlags *reasonFlags,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXReasonFlags_GetMask
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REASON_FLAGS
*
* Return value:
* A valid mask of NSSPKIXReasonFlagsMask values upon success
* NSSPKIXReasonFlagsMask_NSSinvalid upon failure
*/
NSS_EXTERN NSSPKIXReasonFlagsMask
nssPKIXReasonFlags_GetMask
(
NSSPKIXReasonFlags *reasonFlags
);
/*
* nssPKIXReasonFlags_SetMask
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REASON_FLAGS
* NSS_ERROR_INVALID_PKIX_REASON_FLAGS_MASK
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXReasonFlags_SetMask
(
NSSPKIXReasonFlags *reasonFlags,
NSSPKIXReasonFlagsMask mask
);
/*
* nssPKIXReasonFlags_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REASON_FLAGS
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXReasonFlags_Equal
(
NSSPKIXReasonFlags *reasonFlags1,
NSSPKIXReasonFlags *reasonFlags2,
PRStatus *statusOpt
);
/*
* nssPKIXReasonFlags_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REASON_FLAGS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXReasonFlags upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXReasonFlags *
nssPKIXReasonFlags_Duplicate
(
NSSPKIXReasonFlags *reasonFlags,
NSSArena *arenaOpt
);
/*
* { bitwise accessors? }
*
*/
#ifdef DEBUG
/*
* nssPKIXReasonFlags_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXReasonFlags
* object, this routine will return PR_SUCCESS. Otherwise, it will
* put an error on the error stack and return PR_FAILURE.
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REASON_FLAGS
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXReasonFlags_verifyPointer
(
NSSPKIXReasonFlags *p
);
#endif /* DEBUG */
/*
* ExtKeyUsageSyntax
*
* -- fgmr comments --
*
* From RFC 2459:
*
* ExtKeyUsageSyntax ::= SEQUENCE SIZE (1..MAX) OF KeyPurposeId
*
* The private calls for this type:
*
* nssPKIXExtKeyUsageSyntax_Decode
* nssPKIXExtKeyUsageSyntax_Create
* nssPKIXExtKeyUsageSyntax_Destroy
* nssPKIXExtKeyUsageSyntax_Encode
* nssPKIXExtKeyUsageSyntax_GetKeyPurposeIdCount
* nssPKIXExtKeyUsageSyntax_GetKeyPurposeIds
* nssPKIXExtKeyUsageSyntax_SetKeyPurposeIds
* nssPKIXExtKeyUsageSyntax_GetKeyPurposeId
* nssPKIXExtKeyUsageSyntax_SetKeyPurposeId
* nssPKIXExtKeyUsageSyntax_InsertKeyPurposeId
* nssPKIXExtKeyUsageSyntax_AppendKeyPurposeId
* nssPKIXExtKeyUsageSyntax_RemoveKeyPurposeId
* nssPKIXExtKeyUsageSyntax_FindKeyPurposeId
* nssPKIXExtKeyUsageSyntax_Equal
* nssPKIXExtKeyUsageSyntax_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXExtKeyUsageSyntax_verifyPointer
*
*/
/*
* nssPKIXExtKeyUsageSyntax_Decode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_BER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXExtKeyUsageSyntax upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtKeyUsageSyntax *
nssPKIXExtKeyUsageSyntax_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXExtKeyUsageSyntax_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_KEY_PURPOSE_ID
*
* Return value:
* A valid pointer to an NSSPKIXExtKeyUsageSyntax upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtKeyUsageSyntax *
nssPKIXExtKeyUsageSyntax_Create
(
NSSArena *arenaOpt,
NSSPKIXKeyPurposeId *kpid1,
...
);
/*
* nssPKIXExtKeyUsageSyntax_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXT_KEY_USAGE_SYNTAX
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtKeyUsageSyntax_Destroy
(
NSSPKIXExtKeyUsageSyntax *eku
);
/*
* nssPKIXExtKeyUsageSyntax_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXT_KEY_USAGE_SYNTAX
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXExtKeyUsageSyntax_Encode
(
NSSPKIXExtKeyUsageSyntax *eku,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXExtKeyUsageSyntax_GetKeyPurposeIdCount
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXT_KEY_USAGE_SYNTAX
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXExtKeyUsageSyntax_GetKeyPurposeIdCount
(
NSSPKIXExtKeyUsageSyntax *eku
);
/*
* nssPKIXExtKeyUsageSyntax_GetKeyPurposeIds
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXT_KEY_USAGE_SYNTAX
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_ARRAY_TOO_SMALL
*
* Return value:
* A valid pointer to an array of NSSPKIXKeyPurposeId pointers upon
* success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXKeyPurposeId **
nssPKIXExtKeyUsageSyntax_GetKeyPurposeIds
(
NSSPKIXExtKeyUsageSyntax *eku,
NSSPKIXKeyPurposeId *rvOpt[],
PRInt32 limit,
NSSArena *arenaOpt
);
/*
* nssPKIXExtKeyUsageSyntax_SetKeyPurposeIds
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXT_KEY_USAGE_SYNTAX
* NSS_ERROR_INVALID_PKIX_KEY_PURPOSE_ID
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtKeyUsageSyntax_SetKeyPurposeIds
(
NSSPKIXExtKeyUsageSyntax *eku,
NSSPKIXKeyPurposeId *ids[],
PRInt32 count
);
/*
* nssPKIXExtKeyUsageSyntax_GetKeyPurposeId
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXT_KEY_USAGE_SYNTAX
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXKeyPurposeId upon success
* NULL upon error
*/
NSS_EXTERN NSSPKIXKeyPurposeId *
nssPKIXExtKeyUsageSyntax_GetKeyPurposeId
(
NSSPKIXExtKeyUsageSyntax *eku,
PRInt32 i,
NSSArena *arenaOpt
);
/*
* nssPKIXExtKeyUsageSyntax_SetKeyPurposeId
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXT_KEY_USAGE_SYNTAX
* NSS_ERROR_INVALID_PKIX_KEY_PURPOSE_ID
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtKeyUsageSyntax_SetKeyPurposeId
(
NSSPKIXExtKeyUsageSyntax *eku,
PRInt32 i,
NSSPKIXKeyPurposeId *id
);
/*
* nssPKIXExtKeyUsageSyntax_InsertKeyPurposeId
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXT_KEY_USAGE_SYNTAX
* NSS_ERROR_INVALID_PKIX_KEY_PURPOSE_ID
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtKeyUsageSyntax_InsertKeyPurposeId
(
NSSPKIXExtKeyUsageSyntax *eku,
PRInt32 i,
NSSPKIXKeyPurposeId *id
);
/*
* nssPKIXExtKeyUsageSyntax_AppendKeyPurposeId
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXT_KEY_USAGE_SYNTAX
* NSS_ERROR_INVALID_PKIX_KEY_PURPOSE_ID
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtKeyUsageSyntax_AppendKeyPurposeId
(
NSSPKIXExtKeyUsageSyntax *eku,
NSSPKIXKeyPurposeId *id
);
/*
* nssPKIXExtKeyUsageSyntax_RemoveKeyPurposeId
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXT_KEY_USAGE_SYNTAX
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtKeyUsageSyntax_RemoveKeyPurposeId
(
NSSPKIXExtKeyUsageSyntax *eku,
PRInt32 i
);
/*
* nssPKIXExtKeyUsageSyntax_FindKeyPurposeId
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXT_KEY_USAGE_SYNTAX
* NSS_ERROR_INVALID_PKIX_KEY_PURPOSE_ID
* NSS_ERROR_NOT_FOUND
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* The index of the specified key purpose id upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXExtKeyUsageSyntax_FindKeyPurposeId
(
NSSPKIXExtKeyUsageSyntax *eku,
NSSPKIXKeyPurposeId *id
);
/*
* nssPKIXExtKeyUsageSyntax_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXT_KEY_USAGE_SYNTAX
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXExtKeyUsageSyntax_Equal
(
NSSPKIXExtKeyUsageSyntax *eku1,
NSSPKIXExtKeyUsageSyntax *eku2,
PRStatus *statusOpt
);
/*
* nssPKIXExtKeyUsageSyntax_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXT_KEY_USAGE_SYNTAX
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXExtKeyUsageSyntax upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtKeyUsageSyntax *
nssPKIXExtKeyUsageSyntax_Duplicate
(
NSSPKIXExtKeyUsageSyntax *eku,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXExtKeyUsageSyntax_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXExtKeyUsageSyntax
* object, this routine will return PR_SUCCESS. Otherwise, it will
* put an error on the error stack and return PR_FAILURE.
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXT_KEY_USAGE_SYNTAX
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXExtKeyUsageSyntax_verifyPointer
(
NSSPKIXExtKeyUsageSyntax *p
);
#endif /* DEBUG */
/*
* AuthorityInfoAccessSyntax
*
* -- fgmr comments --
*
* From RFC 2459:
*
* AuthorityInfoAccessSyntax ::=
* SEQUENCE SIZE (1..MAX) OF AccessDescription
*
* The private calls for this type:
*
* nssPKIXAuthorityInfoAccessSyntax_Decode
* nssPKIXAuthorityInfoAccessSyntax_Create
* nssPKIXAuthorityInfoAccessSyntax_Destroy
* nssPKIXAuthorityInfoAccessSyntax_Encode
* nssPKIXAuthorityInfoAccessSyntax_GetAccessDescriptionCount
* nssPKIXAuthorityInfoAccessSyntax_GetAccessDescriptions
* nssPKIXAuthorityInfoAccessSyntax_SetAccessDescriptions
* nssPKIXAuthorityInfoAccessSyntax_GetAccessDescription
* nssPKIXAuthorityInfoAccessSyntax_SetAccessDescription
* nssPKIXAuthorityInfoAccessSyntax_InsertAccessDescription
* nssPKIXAuthorityInfoAccessSyntax_AppendAccessDescription
* nssPKIXAuthorityInfoAccessSyntax_RemoveAccessDescription
* nssPKIXAuthorityInfoAccessSyntax_FindAccessDescription
* nssPKIXAuthorityInfoAccessSyntax_Equal
* nssPKIXAuthorityInfoAccessSyntax_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXAuthorityInfoAccessSyntax_verifyPointer
*
*/
/*
* nssPKIXAuthorityInfoAccessSyntax_Decode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_BER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXAuthorityInfoAccessSyntax upon
* success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAuthorityInfoAccessSyntax *
nssPKIXAuthorityInfoAccessSyntax_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXAuthorityInfoAccessSyntax_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_ACCESS_DESCRIPTION
*
* Return value:
* A valid pointer to an NSSPKIXAuthorityInfoAccessSyntax upon
* success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAuthorityInfoAccessSyntax *
nssPKIXAuthorityInfoAccessSyntax_Create
(
NSSArena *arenaOpt,
NSSPKIXAccessDescription *ad1,
...
);
/*
* nssPKIXAuthorityInfoAccessSyntax_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_INFO_ACCESS_SYNTAX
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAuthorityInfoAccessSyntax_Destroy
(
NSSPKIXAuthorityInfoAccessSyntax *aias
);
/*
* nssPKIXAuthorityInfoAccessSyntax_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_INFO_ACCESS_SYNTAX
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXAuthorityInfoAccessSyntax_Encode
(
NSSPKIXAuthorityInfoAccessSyntax *aias,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXAuthorityInfoAccessSyntax_GetAccessDescriptionCount
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_INFO_ACCESS_SYNTAX
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXAuthorityInfoAccessSyntax_GetAccessDescriptionCount
(
NSSPKIXAuthorityInfoAccessSyntax *aias
);
/*
* nssPKIXAuthorityInfoAccessSyntax_GetAccessDescriptions
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_INFO_ACCESS_SYNTAX
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_ARRAY_TOO_SMALL
*
* Return value:
* A valid pointer to an array of NSSPKIXAccessDescription pointers
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAccessDescription **
nssPKIXAuthorityInfoAccessSyntax_GetAccessDescriptions
(
NSSPKIXAuthorityInfoAccessSyntax *aias,
NSSPKIXAccessDescription *rvOpt[],
PRInt32 limit,
NSSArena *arenaOpt
);
/*
* nssPKIXAuthorityInfoAccessSyntax_SetAccessDescriptions
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_INFO_ACCESS_SYNTAX
* NSS_ERROR_INVALID_PKIX_ACCESS_DESCRIPTION
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAuthorityInfoAccessSyntax_SetAccessDescriptions
(
NSSPKIXAuthorityInfoAccessSyntax *aias,
NSSPKIXAccessDescription *ad[],
PRInt32 count
);
/*
* nssPKIXAuthorityInfoAccessSyntax_GetAccessDescription
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_INFO_ACCESS_SYNTAX
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXAccessDescription upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAccessDescription *
nssPKIXAuthorityInfoAccessSyntax_GetAccessDescription
(
NSSPKIXAuthorityInfoAccessSyntax *aias,
PRInt32 i,
NSSArena *arenaOpt
);
/*
* nssPKIXAuthorityInfoAccessSyntax_SetAccessDescription
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_INFO_ACCESS_SYNTAX
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_ACCESS_DESCRIPTION
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAuthorityInfoAccessSyntax_SetAccessDescription
(
NSSPKIXAuthorityInfoAccessSyntax *aias,
PRInt32 i,
NSSPKIXAccessDescription *ad
);
/*
* nssPKIXAuthorityInfoAccessSyntax_InsertAccessDescription
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_INFO_ACCESS_SYNTAX
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_ACCESS_DESCRIPTION
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAuthorityInfoAccessSyntax_InsertAccessDescription
(
NSSPKIXAuthorityInfoAccessSyntax *aias,
PRInt32 i,
NSSPKIXAccessDescription *ad
);
/*
* nssPKIXAuthorityInfoAccessSyntax_AppendAccessDescription
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_INFO_ACCESS_SYNTAX
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_ACCESS_DESCRIPTION
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAuthorityInfoAccessSyntax_AppendAccessDescription
(
NSSPKIXAuthorityInfoAccessSyntax *aias,
NSSPKIXAccessDescription *ad
);
/*
* nssPKIXAuthorityInfoAccessSyntax_RemoveAccessDescription
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_INFO_ACCESS_SYNTAX
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAuthorityInfoAccessSyntax_RemoveAccessDescription
(
NSSPKIXAuthorityInfoAccessSyntax *aias,
PRInt32 i
);
/*
* nssPKIXAuthorityInfoAccessSyntax_FindAccessDescription
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_INFO_ACCESS_SYNTAX
* NSS_ERROR_INVALID_PKIX_ACCESS_DESCRIPTION
* NSS_ERROR_NOT_FOUND
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* The index of the specified policy mapping upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXAuthorityInfoAccessSyntax_FindAccessDescription
(
NSSPKIXAuthorityInfoAccessSyntax *aias,
NSSPKIXAccessDescription *ad
);
/*
* nssPKIXAuthorityInfoAccessSyntax_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_INFO_ACCESS_SYNTAX
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXAuthorityInfoAccessSyntax_Equal
(
NSSPKIXAuthorityInfoAccessSyntax *aias1,
NSSPKIXAuthorityInfoAccessSyntax *aias2,
PRStatus *statusOpt
);
/*
* nssPKIXAuthorityInfoAccessSyntax_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_INFO_ACCESS_SYNTAX
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXAuthorityInfoAccessSyntax upon
* success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAuthorityInfoAccessSyntax *
nssPKIXAuthorityInfoAccessSyntax_Duplicate
(
NSSPKIXAuthorityInfoAccessSyntax *aias,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXAuthorityInfoAccessSyntax_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXAuthorityInfoAccessSyntax
* object, this routine will return PR_SUCCESS. Otherwise, it will
* put an error on the error stack and return PR_FAILURE.
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_INFO_ACCESS_SYNTAX
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXAuthorityInfoAccessSyntax_verifyPointer
(
NSSPKIXAuthorityInfoAccessSyntax *p
);
#endif /* DEBUG */
/*
* AccessDescription
*
* -- fgmr comments --
*
* From RFC 2459:
*
* AccessDescription ::= SEQUENCE {
* accessMethod OBJECT IDENTIFIER,
* accessLocation GeneralName }
*
* The private calls for this type:
*
* nssPKIXAccessDescription_Decode
* nssPKIXAccessDescription_Create
* nssPKIXAccessDescription_Destroy
* nssPKIXAccessDescription_Encode
* nssPKIXAccessDescription_GetAccessMethod
* nssPKIXAccessDescription_SetAccessMethod
* nssPKIXAccessDescription_GetAccessLocation
* nssPKIXAccessDescription_SetAccessLocation
* nssPKIXAccessDescription_Equal
* nssPKIXAccessDescription_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXAccessDescription_verifyPointer
*
*/
/*
* nssPKIXAccessDescription_Decode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_BER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXAccessDescription upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAccessDescription *
nssPKIXAccessDescription_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXAccessDescription_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_OID
* NSS_ERROR_INVALID_PKIX_GENERAL_NAME
*
* Return value:
* A valid pointer to an NSSPKIXAccessDescription upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAccessDescription *
nssPKIXAccessDescription_Create
(
NSSArena *arenaOpt,
NSSOID *accessMethod,
NSSPKIXGeneralName *accessLocation
);
/*
* nssPKIXAccessDescription_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ACCESS_DESCRIPTION
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAccessDescription_Destroy
(
NSSPKIXAccessDescription *ad
);
/*
* nssPKIXAccessDescription_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ACCESS_DESCRIPTION
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXAccessDescription_Encode
(
NSSPKIXAccessDescription *ad,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXAccessDescription_GetAccessMethod
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ACCESS_DESCRIPTION
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSOID pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSOID *
nssPKIXAccessDescription_GetAccessMethod
(
NSSPKIXAccessDescription *ad
);
/*
* nssPKIXAccessDescription_SetAccessMethod
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ACCESS_DESCRIPTION
* NSS_ERROR_INVALID_OID
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAccessDescription_SetAccessMethod
(
NSSPKIXAccessDescription *ad,
NSSOID *accessMethod
);
/*
* nssPKIXAccessDescription_GetAccessLocation
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ACCESS_DESCRIPTION
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXGeneralName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXGeneralName *
nssPKIXAccessDescription_GetAccessLocation
(
NSSPKIXAccessDescription *ad,
NSSArena *arenaOpt
);
/*
* nssPKIXAccessDescription_SetAccessLocation
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ACCESS_DESCRIPTION
* NSS_ERROR_INVALID_PKIX_GENERAL_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAccessDescription_SetAccessLocation
(
NSSPKIXAccessDescription *ad,
NSSPKIXGeneralName *accessLocation
);
/*
* nssPKIXAccessDescription_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ACCESS_DESCRIPTION
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXAccessDescription_Equal
(
NSSPKIXAccessDescription *ad1,
NSSPKIXAccessDescription *ad2,
PRStatus *statusOpt
);
/*
* nssPKIXAccessDescription_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ACCESS_DESCRIPTION
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXAccessDescription upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAccessDescription *
nssPKIXAccessDescription_Duplicate
(
NSSPKIXAccessDescription *ad,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXAccessDescription_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXAccessDescription
* object, this routine will return PR_SUCCESS. Otherwise, it will
* put an error on the error stack and return PR_FAILURE.
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ACCESS_DESCRIPTION
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXAccessDescription_verifyPointer
(
NSSPKIXAccessDescription *p
);
#endif /* DEBUG */
/*
* IssuingDistributionPoint
*
* -- fgmr comments --
*
* From RFC 2459:
*
* IssuingDistributionPoint ::= SEQUENCE {
* distributionPoint [0] DistributionPointName OPTIONAL,
* onlyContainsUserCerts [1] BOOLEAN DEFAULT FALSE,
* onlyContainsCACerts [2] BOOLEAN DEFAULT FALSE,
* onlySomeReasons [3] ReasonFlags OPTIONAL,
* indirectCRL [4] BOOLEAN DEFAULT FALSE }
*
* The private calls for this type:
*
* nssPKIXIssuingDistributionPoint_Decode
* nssPKIXIssuingDistributionPoint_Create
* nssPKIXIssuingDistributionPoint_Destroy
* nssPKIXIssuingDistributionPoint_Encode
* nssPKIXIssuingDistributionPoint_HasDistributionPoint
* nssPKIXIssuingDistributionPoint_GetDistributionPoint
* nssPKIXIssuingDistributionPoint_SetDistributionPoint
* nssPKIXIssuingDistributionPoint_RemoveDistributionPoint
* nssPKIXIssuingDistributionPoint_GetOnlyContainsUserCerts
* nssPKIXIssuingDistributionPoint_SetOnlyContainsUserCerts
* nssPKIXIssuingDistributionPoint_GetOnlyContainsCACerts
* nssPKIXIssuingDistributionPoint_SetOnlyContainsCACerts
* nssPKIXIssuingDistributionPoint_HasOnlySomeReasons
* nssPKIXIssuingDistributionPoint_GetOnlySomeReasons
* nssPKIXIssuingDistributionPoint_SetOnlySomeReasons
* nssPKIXIssuingDistributionPoint_RemoveOnlySomeReasons
* nssPKIXIssuingDistributionPoint_GetIndirectCRL
* nssPKIXIssuingDistributionPoint_SetIndirectCRL
* nssPKIXIssuingDistributionPoint_Equal
* nssPKIXIssuingDistributionPoint_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXIssuingDistributionPoint_verifyPointer
*
*/
/*
* nssPKIXIssuingDistributionPoint_Decode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_BER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXIssuingDistributionPoint upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXIssuingDistributionPoint *
nssPKIXIssuingDistributionPoint_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXIssuingDistributionPoint_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT_NAME
* NSS_ERROR_INVALID_PKIX_REASON_FLAGS
*
* Return value:
* A valid pointer to an NSSPKIXIssuingDistributionPoint upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXIssuingDistributionPoint *
nssPKIXIssuingDistributionPoint_Create
(
NSSArena *arenaOpt,
NSSPKIXDistributionPointName *distributionPointOpt,
PRBool onlyContainsUserCerts,
PRBool onlyContainsCACerts,
NSSPKIXReasonFlags *onlySomeReasons
PRBool indirectCRL
);
/*
* nssPKIXIssuingDistributionPoint_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXIssuingDistributionPoint_Destroy
(
NSSPKIXIssuingDistributionPoint *idp
);
/*
* nssPKIXIssuingDistributionPoint_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXIssuingDistributionPoint_Encode
(
NSSPKIXIssuingDistributionPoint *idp,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXIssuingDistributionPoint_HasDistributionPoint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXIssuingDistributionPoint_HasDistributionPoint
(
NSSPKIXIssuingDistributionPoint *idp
);
/*
* nssPKIXIssuingDistributionPoint_GetDistributionPoint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
* NSS_ERROR_HAS_NO_DISTRIBUTION_POINT
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXDistributionPointName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXDistributionPointName *
nssPKIXIssuingDistributionPoint_GetDistributionPoint
(
NSSPKIXIssuingDistributionPoint *idp,
NSSArena *arenaOpt
);
/*
* nssPKIXIssuingDistributionPoint_SetDistributionPoint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
* NSS_ERROR_INVALID_PKIX_DISTRIBUTION_POINT_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXIssuingDistributionPoint_SetDistributionPoint
(
NSSPKIXIssuingDistributionPoint *idp,
NSSPKIXDistributionPointName *dpn
);
/*
* nssPKIXIssuingDistributionPoint_RemoveDistributionPoint
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
* NSS_ERROR_HAS_NO_DISTRIBUTION_POINT
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXIssuingDistributionPoint_RemoveDistributionPoint
(
NSSPKIXIssuingDistributionPoint *idp
);
/*
* nssPKIXIssuingDistributionPoint_GetOnlyContainsUserCerts
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
*
* Return value:
* PR_TRUE if the onlyContainsUserCerts value is true
* PR_FALSE if it isn't
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXIssuingDistributionPoint_GetOnlyContainsUserCerts
(
NSSPKIXIssuingDistributionPoint *idp,
PRStatus *statusOpt
);
/*
* nssPKIXIssuingDistributionPoint_SetOnlyContainsUserCerts
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXIssuingDistributionPoint_SetOnlyContainsUserCerts
(
NSSPKIXIssuingDistributionPoint *idp,
PRBool onlyContainsUserCerts
);
/*
* nssPKIXIssuingDistributionPoint_GetOnlyContainsCACerts
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
*
* Return value:
* PR_TRUE if the onlyContainsCACerts value is true
* PR_FALSE if it isn't
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXIssuingDistributionPoint_GetOnlyContainsCACerts
(
NSSPKIXIssuingDistributionPoint *idp,
PRStatus *statusOpt
);
/*
* nssPKIXIssuingDistributionPoint_SetOnlyContainsCACerts
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXIssuingDistributionPoint_SetOnlyContainsCACerts
(
NSSPKIXIssuingDistributionPoint *idp,
PRBool onlyContainsCACerts
);
/*
* nssPKIXIssuingDistributionPoint_HasOnlySomeReasons
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXIssuingDistributionPoint_HasOnlySomeReasons
(
NSSPKIXIssuingDistributionPoint *idp
);
/*
* nssPKIXIssuingDistributionPoint_GetOnlySomeReasons
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
* NSS_ERROR_HAS_NO_ONLY_SOME_REASONS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXReasonFlags upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXReasonFlags *
nssPKIXIssuingDistributionPoint_GetOnlySomeReasons
(
NSSPKIXIssuingDistributionPoint *idp,
NSSArena *arenaOpt
);
/*
* nssPKIXIssuingDistributionPoint_SetOnlySomeReasons
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
* NSS_ERROR_INVALID_PKIX_REASON_FLAGS
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXIssuingDistributionPoint_SetOnlySomeReasons
(
NSSPKIXIssuingDistributionPoint *idp,
NSSPKIXReasonFlags *onlySomeReasons
);
/*
* nssPKIXIssuingDistributionPoint_RemoveOnlySomeReasons
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
* NSS_ERROR_HAS_NO_ONLY_SOME_REASONS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXIssuingDistributionPoint_RemoveOnlySomeReasons
(
NSSPKIXIssuingDistributionPoint *idp
);
/*
* nssPKIXIssuingDistributionPoint_GetIndirectCRL
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
*
* Return value:
* PR_TRUE if the indirectCRL value is true
* PR_FALSE if it isn't
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXIssuingDistributionPoint_GetIndirectCRL
(
NSSPKIXIssuingDistributionPoint *idp,
PRStatus *statusOpt
);
/*
* nssPKIXIssuingDistributionPoint_SetIndirectCRL
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXIssuingDistributionPoint_SetIndirectCRL
(
NSSPKIXIssuingDistributionPoint *idp,
PRBool indirectCRL
);
/*
* nssPKIXIssuingDistributionPoint_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXIssuingDistributionPoint_Equal
(
NSSPKIXIssuingDistributionPoint *idp1,
NSSPKIXIssuingDistributionPoint *idp2,
PRStatus *statusOpt
);
/*
* nssPKIXIssuingDistributionPoint_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXIssuingDistributionPoint upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXIssuingDistributionPoint *
nssPKIXIssuingDistributionPoint_Duplicate
(
NSSPKIXIssuingDistributionPoint *idp,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXIssuingDistributionPoint_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXIssuingDistributionPoint
* object, this routine will return PR_SUCCESS. Otherwise, it will
* put an error on the error stack and return PR_FAILURE.
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ISSUING_DISTRIBUTION_POINT
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXIssuingDistributionPoint_verifyPointer
(
NSSPKIXIssuingDistributionPoint *p
);
#endif /* DEBUG */
PR_END_EXTERN_C
#endif /* NSSPKIX_H */