CA认证

开发平台：

WINDOWS

pkix.h：源码内容

* NULL upon failure
*/
NSS_EXTERN NSSPKIXAlgorithmIdentifier *
nssPKIXSubjectPublicKeyInfo_GetAlgorithm
(
NSSPKIXSubjectPublicKeyInfo *spki,
NSSArena *arenaOpt
);
/*
* nssPKIXSubjectPublicKeyInfo_SetAlgorithm
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_PUBLIC_KEY_INFO
* NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXSubjectPublicKeyInfo_SetAlgorithm
(
NSSPKIXSubjectPublicKeyInfo *spki,
NSSPKIXAlgorithmIdentifier *algid
);
/*
* nssPKIXSubjectPublicKeyInfo_GetSubjectPublicKey
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_PUBLIC_KEY_INFO
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSItem upon success
* NULL upon failure
*/
NSS_EXTERN NSSItem *
nssPKIXSubjectPublicKeyInfo_GetSubjectPublicKey
(
NSSPKIXSubjectPublicKeyInfo *spki,
NSSItem *spkOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXSubjectPublicKeyInfo_SetSubjectPublicKey
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_PUBLIC_KEY_INFO
* NSS_ERROR_INVALID_ITEM
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXSubjectPublicKeyInfo_SetSubjectPublicKey
(
NSSPKIXSubjectPublicKeyInfo *spki,
NSSItem *spk
);
/*
* nssPKIXSubjectPublicKeyInfo_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_PUBLIC_KEY_INFO
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXSubjectPublicKeyInfo_Equal
(
NSSPKIXSubjectPublicKeyInfo *one,
NSSPKIXSubjectPublicKeyInfo *two,
PRStatus *statusOpt
);
/*
* nssPKIXSubjectPublicKeyInfo_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_SUBJECT_PUBLIC_KEY_INFO
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXSubjectPublicKeyInfo upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXSubjectPublicKeyInfo *
nssPKIXSubjectPublicKeyInfo_Duplicate
(
NSSPKIXSubjectPublicKeyInfo *spki,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXSubjectPublicKeyInfo_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXSubjectPublicKeyInfo
* 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_PUBLIC_KEY_INFO
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXSubjectPublicKeyInfo_verifyPointer
(
NSSPKIXSubjectPublicKeyInfo *p
);
#endif /* DEBUG */
/*
* Extensions
*
* -- fgmr comments --
*
* From RFC 2459:
*
* Extensions ::= SEQUENCE SIZE (1..MAX) OF Extension
*
*/
/* { FGMR } */
/*
* Extension
*
* -- fgmr comments --
*
* From RFC 2459:
*
* Extension ::= SEQUENCE {
* extnID OBJECT IDENTIFIER,
* critical BOOLEAN DEFAULT FALSE,
* extnValue OCTET STRING }
*
*/
/* { FGMR } */
/*
* CertificateList
*
* -- fgmr comments --
*
* From RFC 2459:
*
* CertificateList ::= SEQUENCE {
* tbsCertList TBSCertList,
* signatureAlgorithm AlgorithmIdentifier,
* signature BIT STRING }
*
* The private calls for the type:
*
* nssPKIXCertificateList_Decode
* nssPKIXCertificateList_Create
* nssPKIXCertificateList_Encode
* nssPKIXCertificateList_Destroy
* nssPKIXCertificateList_GetTBSCertList
* nssPKIXCertificateList_SetTBSCertList
* nssPKIXCertificateList_GetSignatureAlgorithm
* nssPKIXCertificateList_SetSignatureAlgorithm
* nssPKIXCertificateList_GetSignature
* nssPKIXCertificateList_SetSignature
* nssPKIXCertificateList_Equal
* nssPKIXCertificateList_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXCertificateList_verifyPointer
*
*/
/*
* nssPKIXCertificateList_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 NSSPKIXCertificateList upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXCertificateList *
nssPKIXCertificateList_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXCertificateList_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
* NSS_ERROR_INVALID_ITEM
*
* Return value:
* A valid pointer to an NSSPKIXCertificateList upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXCertificateList *
nssPKIXCertificateList_Create
(
NSSArena *arenaOpt,
NSSPKIXTBSCertList *tbsCertList,
NSSPKIXAlgorithmIdentifier *sigAlg,
NSSItem *signature
);
/*
* nssPKIXCertificateList_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXCertificateList_Destroy
(
NSSPKIXCertificateList *certList
);
/*
* nssPKIXCertificateList_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXCertificateList_Encode
(
NSSPKIXCertificateList *certList,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXCertificateList_GetTBSCertList
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXTBSCertList upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTBSCertList *
nssPKIXCertificateList_GetTBSCertList
(
NSSPKIXCertificateList *certList,
NSSArena *arenaOpt
);
/*
* nssPKIXCertificateList_SetTBSCertList
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXCertificateList_SetTBSCertList
(
NSSPKIXCertificateList *certList,
NSSPKIXTBSCertList *tbsCertList
);
/*
* nssPKIXCertificateList_GetSignatureAlgorithm
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXAlgorithmIdentifier upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAlgorithmIdentifier *
nssPKIXCertificateList_GetSignatureAlgorithm
(
NSSPKIXCertificateList *certList,
NSSArena *arenaOpt
);
/*
* nssPKIXCertificateList_SetSignatureAlgorithm
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
* NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXCertificateList_SetSignatureAlgorithm
(
NSSPKIXCertificateList *certList,
NSSPKIXAlgorithmIdentifier *sigAlg
);
/*
* nssPKIXCertificateList_GetSignature
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSItem upon success
* NULL upon failure
*/
NSS_EXTERN NSSItem *
nssPKIXCertificateList_GetSignature
(
NSSPKIXCertificateList *certList,
NSSItem *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXCertificateList_SetSignature
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
* NSS_ERROR_INVALID_ITEM
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXCertificateList_SetSignature
(
NSSPKIXCertificateList *certList,
NSSItem *sig
);
/*
* nssPKIXCertificateList_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXCertificateList_Equal
(
NSSPKIXCertificateList *one,
NSSPKIXCertificateList *two,
PRStatus *statusOpt
);
/*
* nssPKIXCertificateList_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXCertificateList upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXCertificateList *
nssPKIXCertificateList_Duplicate
(
NSSPKIXCertificateList *certList,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXCertificateList_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXCertificateList
* 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_CERTIFICATE_LIST
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXCertificateList_verifyPointer
(
NSSPKIXCertificateList *p
);
#endif /* DEBUG */
/*
* TBSCertList
*
* -- fgmr comments --
*
* From RFC 2459:
*
* TBSCertList ::= SEQUENCE {
* version Version OPTIONAL,
* -- if present, shall be v2
* signature AlgorithmIdentifier,
* issuer Name,
* thisUpdate Time,
* nextUpdate Time OPTIONAL,
* revokedCertificates SEQUENCE OF SEQUENCE {
* userCertificate CertificateSerialNumber,
* revocationDate Time,
* crlEntryExtensions Extensions OPTIONAL
* -- if present, shall be v2
* } OPTIONAL,
* crlExtensions [0] Extensions OPTIONAL
* -- if present, shall be v2 -- }
*
* The private calls for the type:
*
* nssPKIXTBSCertList_Decode
* nssPKIXTBSCertList_Create
* nssPKIXTBSCertList_Destroy
* nssPKIXTBSCertList_Encode
* nssPKIXTBSCertList_GetVersion
* nssPKIXTBSCertList_SetVersion
* nssPKIXTBSCertList_GetSignature
* nssPKIXTBSCertList_SetSignature
* nssPKIXTBSCertList_GetIssuer
* nssPKIXTBSCertList_SetIssuer
* nssPKIXTBSCertList_GetThisUpdate
* nssPKIXTBSCertList_SetThisUpdate
* nssPKIXTBSCertList_HasNextUpdate
* nssPKIXTBSCertList_GetNextUpdate
* nssPKIXTBSCertList_SetNextUpdate
* nssPKIXTBSCertList_RemoveNextUpdate
* nssPKIXTBSCertList_GetRevokedCertificates
* nssPKIXTBSCertList_SetRevokedCertificates
* nssPKIXTBSCertList_HasCrlExtensions
* nssPKIXTBSCertList_GetCrlExtensions
* nssPKIXTBSCertList_SetCrlExtensions
* nssPKIXTBSCertList_RemoveCrlExtensions
* nssPKIXTBSCertList_Equal
* nssPKIXTBSCertList_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXTBSCertList_verifyPointer
*
*/
/*
* nssPKIXTBSCertList_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 NSSPKIXTBSCertList upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTBSCertList *
nssPKIXTBSCertList_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXTBSCertList_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_VERSION
* NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
* NSS_ERROR_INVALID_PKIX_NAME
* NSS_ERROR_INVALID_PKIX_TIME
* (something for the times being out of order?)
* NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATES
* NSS_ERROR_INVALID_PKIX_EXTENSIONS
*
* Return value:
* A valid pointer to an NSSPKIXTBSCertList upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTBSCertList *
nssPKIXTBSCertList_Create
(
NSSArena *arenaOpt,
NSSPKIXVersion version,
NSSPKIXAlgorithmIdentifier *signature,
NSSPKIXName *issuer,
NSSPKIXTime thisUpdate,
NSSPKIXTime nextUpdateOpt,
NSSPKIXrevokedCertificates *revokedCerts,
NSSPKIXExtensions *crlExtensionsOpt
);
/*
* nssPKIXTBSCertList_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTBSCertList_Destroy
(
NSSPKIXTBSCertList *certList
);
/*
* nssPKIXTBSCertList_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXTBSCertList_Encode
(
NSSPKIXTBSCertList *certList,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXTBSCertList_GetVersion
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* A valid element of the NSSPKIXVersion enumeration upon success
* NSSPKIXVersion_NSSinvalid (-1) upon failure
*/
NSS_EXTERN NSSPKIXVersion
nssPKIXTBSCertList_GetVersion
(
NSSPKIXTBSCertList *certList
);
/*
* nssPKIXTBSCertList_SetVersion
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_INVALID_PKIX_VERSION
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTBSCertList_SetVersion
(
NSSPKIXTBSCertList *certList,
NSSPKIXVersion version
);
/*
* nssPKIXTBSCertList_GetSignature
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXAlgorithmIdentifier upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAlgorithmIdentifier *
nssPKIXTBSCertList_GetSignature
(
NSSPKIXTBSCertList *certList,
NSSArena *arenaOpt
);
/*
* nssPKIXTBSCertList_SetSignature
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTBSCertList_SetSignature
(
NSSPKIXTBSCertList *certList,
NSSPKIXAlgorithmIdentifier *algid,
);
/*
* nssPKIXTBSCertList_GetIssuer
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXName *
nssPKIXTBSCertList_GetIssuer
(
NSSPKIXTBSCertList *certList,
NSSArena *arenaOpt
);
/*
* nssPKIXTBSCertList_SetIssuer
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_INVALID_PKIX_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTBSCertList_SetIssuer
(
NSSPKIXTBSCertList *certList,
NSSPKIXName *issuer
);
/*
* nssPKIXTBSCertList_GetThisUpdate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* A valid NSSPKIXTime upon success
* {we need to rethink NSSPKIXTime}
*/
NSS_EXTERN NSSPKIXTime
nssPKIXTBSCertList_GetThisUpdate
(
NSSPKIXTBSCertList *certList
);
/*
* nssPKIXTBSCertList_SetThisUpdate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_VALUE_TOO_LARGE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTBSCertList_SetThisUpdate
(
NSSPKIXTBSCertList *certList,
NSSPKIXTime thisUpdate
);
/*
* nssPKIXTBSCertList_HasNextUpdate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXTBSCertList_HasNextUpdate
(
NSSPKIXTBSCertList *certList,
PRStatus *statusOpt
);
/*
* nssPKIXTBSCertList_GetNextUpdate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* A valid NSSPKIXTime upon success
* {we need to rethink NSSPKIXTime}
*/
NSS_EXTERN NSSPKIXTime
nssPKIXTBSCertList_GetNextUpdate
(
NSSPKIXTBSCertList *certList
);
/*
* nssPKIXTBSCertList_SetNextUpdate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_VALUE_TOO_SMALL
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTBSCertList_SetNextUpdate
(
NSSPKIXTBSCertList *certList,
NSSPKIXTime nextUpdate
);
/*
* nssPKIXTBSCertList_RemoveNextUpdate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_HAS_NO_NEXT_UPDATE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTBSCertList_RemoveNextUpdate
(
NSSPKIXTBSCertList *certList
);
/*
* nssPKIXTBSCertList_GetRevokedCertificates
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXrevokedCertificates upon succes
* NULL upon failure
*/
NSS_EXTERN NSSPKIXrevokedCertificates *
nssPKIXTBSCertList_GetRevokedCertificates
(
NSSPKIXTBSCertList *certList,
NSSArena *arenaOpt
);
/*
* nssPKIXTBSCertList_SetRevokedCertificates
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATES
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTBSCertList_SetRevokedCertificates
(
NSSPKIXTBSCertList *certList,
NSSPKIXrevokedCertificates *revoked
);
/*
* nssPKIXTBSCertList_HasCrlExtensions
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXTBSCertList_HasCrlExtensions
(
NSSPKIXTBSCertList *certList,
PRStatus *statusOpt
);
/*
* nssPKIXTBSCertList_GetCrlExtensions
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXExtensions upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtensions *
nssPKIXTBSCertList_GetCrlExtensions
(
NSSPKIXTBSCertList *certList,
NSSArena *arenaOpt
);
/*
* nssPKIXTBSCertList_SetCrlExtensions
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_INVALID_PKIX_EXTENSIONS
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTBSCertList_SetCrlExtensions
(
NSSPKIXTBSCertList *certList,
NSSPKIXExtensions *extensions
);
/*
* nssPKIXTBSCertList_RemoveCrlExtensions
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_HAS_NO_EXTENSIONS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTBSCertList_RemoveCrlExtensions
(
NSSPKIXTBSCertList *certList
);
/*
* nssPKIXTBSCertList_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXTBSCertList_Equal
(
NSSPKIXTBSCertList *one,
NSSPKIXTBSCertList *two,
PRStatus *statusOpt
);
/*
* nssPKIXTBSCertList_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXTBSCertList upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTBSCertList *
nssPKIXTBSCertList_Duplicate
(
NSSPKIXTBSCertList *certList,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXTBSCertList_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXTBSCertList
* 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_TBS_CERT_LIST
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXTBSCertList_verifyPointer
(
NSSPKIXTBSCertList *p
);
#endif /* DEBUG */
/*
* revokedCertificates
*
* This is a "helper type" to simplify handling of TBSCertList objects.
*
* revokedCertificates SEQUENCE OF SEQUENCE {
* userCertificate CertificateSerialNumber,
* revocationDate Time,
* crlEntryExtensions Extensions OPTIONAL
* -- if present, shall be v2
* } OPTIONAL,
*
* The private calls for the type:
*
* nssPKIXrevokedCertificates_Decode
* nssPKIXrevokedCertificates_Create
* nssPKIXrevokedCertificates_Encode
* nssPKIXrevokedCertificates_Destroy
* nssPKIXrevokedCertificates_GetRevokedCertificateCount
* nssPKIXrevokedCertificates_GetRevokedCertificates
* nssPKIXrevokedCertificates_SetRevokedCertificates
* nssPKIXrevokedCertificates_GetRevokedCertificate
* nssPKIXrevokedCertificates_SetRevokedCertificate
* nssPKIXrevokedCertificates_InsertRevokedCertificate
* nssPKIXrevokedCertificates_AppendRevokedCertificate
* nssPKIXrevokedCertificates_RemoveRevokedCertificate
* nssPKIXrevokedCertificates_Equal
* nssPKIXrevokedCertificates_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXrevokedCertificates_verifyPointer
*
*/
/*
* nssPKIXrevokedCertificates_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 NSSPKIXrevokedCertificates upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXrevokedCertificates *
nssPKIXrevokedCertificates_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXrevokedCertificates_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_REVOKED_CERTIFICATE
*
* Return value:
* A valid pointer to an NSSPKIXrevokedCertificates upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXrevokedCertificates *
nssPKIXrevokedCertificates_Create
(
NSSArena *arenaOpt,
NSSPKIXrevokedCertificate *rc1,
...
);
/*
* nssPKIXrevokedCertificates_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_REVOKED_CERTIFICATES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXrevokedCertificates_Destroy
(
NSSPKIXrevokedCertificates *rcs
);
/*
* nssPKIXrevokedCertificates_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_REVOKED_CERTIFICATES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXrevokedCertificates_Encode
(
NSSPKIXrevokedCertificates *rcs,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXrevokedCertificates_GetRevokedCertificateCount
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_REVOKED_CERTIFICATES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXrevokedCertificates_GetRevokedCertificateCount
(
NSSPKIXrevokedCertificates *rcs
);
/*
* nssPKIXrevokedCertificates_GetRevokedCertificates
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_REVOKED_CERTIFICATES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_ARRAY_TOO_SMALL
*
* Return value:
* A valid pointer to an array of NSSPKIXrevokedCertificate pointers
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXrevokedCertificate **
nssPKIXrevokedCertificates_GetRevokedCertificates
(
NSSPKIXrevokedCertificates *rcs,
NSSPKIXrevokedCertificate *rvOpt[],
PRInt32 limit,
NSSArena *arenaOpt
);
/*
* nssPKIXrevokedCertificates_SetRevokedCertificates
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_REVOKED_CERTIFICATES
* NSS_ERROR_INVALID_REVOKED_CERTIFICATE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXrevokedCertificates_SetRevokedCertificates
(
NSSPKIXrevokedCertificates *rcs,
NSSPKIXrevokedCertificate *rc[],
PRInt32 countOpt
);
/*
* nssPKIXrevokedCertificates_GetRevokedCertificate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_REVOKED_CERTIFICATES
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXrevokedCertificate upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXrevokedCertificate *
nssPKIXrevokedCertificates_GetRevokedCertificate
(
NSSPKIXrevokedCertificates *rcs,
PRInt32 i,
NSSArena *arenaOpt
);
/*
* nssPKIXrevokedCertificates_SetRevokedCertificate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_REVOKED_CERTIFICATES
* NSS_ERROR_INVALID_REVOKED_CERTIFICATE
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXrevokedCertificates_SetRevokedCertificate
(
NSSPKIXrevokedCertificates *rcs,
PRInt32 i,
NSSPKIXrevokedCertificate *rc
);
/*
* nssPKIXrevokedCertificates_InsertRevokedCertificate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_REVOKED_CERTIFICATES
* NSS_ERROR_INVALID_REVOKED_CERTIFICATE
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXrevokedCertificates_InsertRevokedCertificate
(
NSSPKIXrevokedCertificates *rcs,
PRInt32 i,
NSSPKIXrevokedCertificate *rc
);
/*
* nssPKIXrevokedCertificates_AppendRevokedCertificate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_REVOKED_CERTIFICATES
* NSS_ERROR_INVALID_REVOKED_CERTIFICATE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXrevokedCertificates_AppendRevokedCertificate
(
NSSPKIXrevokedCertificates *rcs,
PRInt32 i,
NSSPKIXrevokedCertificate *rc
);
/*
* nssPKIXrevokedCertificates_RemoveRevokedCertificate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_REVOKED_CERTIFICATES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXrevokedCertificates_RemoveRevokedCertificate
(
NSSPKIXrevokedCertificates *rcs,
PRInt32 i
);
/*
* nssPKIXrevokedCertificates_FindRevokedCertificate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_REVOKED_CERTIFICATES
* NSS_ERROR_INVALID_REVOKED_CERTIFICATE
*
* Return value:
* The index of the specified revoked certificate upon success
* -1 upon failure
*/
NSS_EXTERN PRInt32
nssPKIXrevokedCertificates_FindRevokedCertificate
(
NSSPKIXrevokedCertificates *rcs,
NSSPKIXrevokedCertificate *rc
);
/*
* nssPKIXrevokedCertificates_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_REVOKED_CERTIFICATES
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXrevokedCertificates_Equal
(
NSSPKIXrevokedCertificates *one,
NSSPKIXrevokedCertificates *two,
PRStatus *statusOpt
);
/*
* nssPKIXrevokedCertificates_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_REVOKED_CERTIFICATES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXrevokedCertificates upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXrevokedCertificates *
nssPKIXrevokedCertificates_Duplicate
(
NSSPKIXrevokedCertificates *rcs,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXrevokedCertificates_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXrevokedCertificates
* 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_REVOKED_CERTIFICATES
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXrevokedCertificates_verifyPointer
(
NSSPKIXrevokedCertificates *p
);
#endif /* DEBUG */
/*
* revokedCertificate
*
* This is a "helper type" to simplify handling of TBSCertList objects.
*
* SEQUENCE {
* userCertificate CertificateSerialNumber,
* revocationDate Time,
* crlEntryExtensions Extensions OPTIONAL
* -- if present, shall be v2
* } OPTIONAL,
*
* The private calls for this type:
*
* nssPKIXrevokedCertificate_Decode
* nssPKIXrevokedCertificate_Create
* nssPKIXrevokedCertificate_Encode
* nssPKIXrevokedCertificate_Destroy
* nssPKIXrevokedCertificate_GetUserCertificate
* nssPKIXrevokedCertificate_SetUserCertificate
* nssPKIXrevokedCertificate_GetRevocationDate
* nssPKIXrevokedCertificate_SetRevocationDate
* nssPKIXrevokedCertificate_HasCrlEntryExtensions
* nssPKIXrevokedCertificate_GetCrlEntryExtensions
* nssPKIXrevokedCertificate_SetCrlEntryExtensions
* nssPKIXrevokedCertificate_RemoveCrlEntryExtensions
* nssPKIXrevokedCertificate_Equal
* nssPKIXrevokedCertificate_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXrevokedCertificate_verifyPointer
*
*/
/*
* nssPKIXrevokedCertificate_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 NSSPKIXrevokedCertificate upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXrevokedCertificate *
nssPKIXrevokedCertificate_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXrevokedCertificate_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_CERTIFICATE_SERIAL_NUMBER
* NSS_ERROR_INVALID_PKIX_TIME
* NSS_ERROR_INVALID_PKIX_EXTENSIONS
*
* Return value:
* A valid pointer to an NSSPKIXrevokedCertificate upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXrevokedCertificate *
nssPKIXrevokedCertificate_Create
(
NSSArena *arenaOpt,
NSSPKIXCertificateSerialNumber *userCertificate,
NSSPKIXTime *revocationDate,
NSSPKIXExtensions *crlEntryExtensionsOpt
);
/*
* nssPKIXrevokedCertificate_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXrevokedCertificate_Destroy
(
NSSPKIXrevokedCertificate *rc
);
/*
* nssPKIXrevokedCertificate_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXrevokedCertificate_Encode
(
NSSPKIXrevokedCertificate *rc,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXrevokedCertificate_GetUserCertificate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXCertificateSerialNumber upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXCertificateSerialNumber *
nssPKIXrevokedCertificate_GetUserCertificate
(
NSSPKIXrevokedCertificate *rc,
NSSArena *arenaOpt
);
/*
* nssPKIXrevokedCertificate_SetUserCertificate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_CERTIFICATE_SERIAL_NUMBER
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXrevokedCertificate_SetUserCertificate
(
NSSPKIXrevokedCertificate *rc,
NSSPKIXCertificateSerialNumber *csn
);
/*
* nssPKIXrevokedCertificate_GetRevocationDate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXTime upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTime *
nssPKIXrevokedCertificate_GetRevocationDate
(
NSSPKIXrevokedCertificate *rc,
NSSArena *arenaOpt
);
/*
* nssPKIXrevokedCertificate_SetRevocationDate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_TIME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXrevokedCertificate_SetRevocationDate
(
NSSPKIXrevokedCertificate *rc,
NSSPKIXTime *revocationDate
);
/*
* nssPKIXrevokedCertificate_HasCrlEntryExtensions
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXrevokedCertificate_HasCrlEntryExtensions
(
NSSPKIXrevokedCertificate *rc,
PRStatus *statusOpt
);
/*
* nssPKIXrevokedCertificate_GetCrlEntryExtensions
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_NO_EXTENSIONS
*
* Return value:
* A valid pointer to an NSSPKIXExtensions upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtensions *
nssPKIXrevokedCertificate_GetCrlEntryExtensions
(
NSSPKIXrevokedCertificate *rc,
NSSArena *arenaOpt
);
/*
* nssPKIXrevokedCertificate_SetCrlEntryExtensions
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_EXTENSIONS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXrevokedCertificate_SetCrlEntryExtensions
(
NSSPKIXrevokedCertificate *rc,
NSSPKIXExtensions *crlEntryExtensions
);
/*
* nssPKIXrevokedCertificate_RemoveCrlEntryExtensions
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
* NSS_ERROR_NO_EXTENSIONS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXrevokedCertificate_RemoveCrlEntryExtensions
(
NSSPKIXrevokedCertificate *rc
);
/*
* nssPKIXrevokedCertificate_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXrevokedCertificate_Equal
(
NSSPKIXrevokedCertificate *one,
NSSPKIXrevokedCertificate *two,
PRStatus *statusOpt
);
/*
* nssPKIXrevokedCertificate_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
*
* Return value:
* A valid pointer to an NSSPKIXrevokedCertificate upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXrevokedCertificate *
nssPKIXrevokedCertificate_Duplicate
(
NSSPKIXrevokedCertificate *rc,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXrevokedCertificate_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXrevokedCertificate
* 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_REVOKED_CERTIFICATE
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXrevokedCertificate_verifyPointer
(
NSSPKIXrevokedCertificate *p
);
#endif /* DEBUG */
/*
* AlgorithmIdentifier
*
* -- fgmr comments --
*
* From RFC 2459:
*
* (1988 syntax)
*
* AlgorithmIdentifier ::= SEQUENCE {
* algorithm OBJECT IDENTIFIER,
* parameters ANY DEFINED BY algorithm OPTIONAL }
* -- contains a value of the type
* -- registered for use with the
* -- algorithm object identifier value
*
* The private calls for this type:
*
* nssPKIXAlgorithmIdentifier_Decode
* nssPKIXAlgorithmIdentifier_Create
* nssPKIXAlgorithmIdentifier_Encode
* nssPKIXAlgorithmIdentifier_Destroy
* nssPKIXAlgorithmIdentifier_GetAlgorithm
* nssPKIXAlgorithmIdentifier_SetAlgorithm
* nssPKIXAlgorithmIdentifier_GetParameters
* nssPKIXAlgorithmIdentifier_SetParameters
* nssPKIXAlgorithmIdentifier_Compare
* nssPKIXAlgorithmIdentifier_Duplicate
* { algorithm-specific parameter types and accessors ? }
*
* In debug builds, the following call is available:
*
* nssPKIXAlgorithmIdentifier_verifyPointer
*
*/
/*
* nssPKIXAlgorithmIdentifier_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 NSSPKIXAlgorithmIdentifier upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAlgorithmIdentifier *
nssPKIXAlgorithmIdentifier_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXAlgorithmIdentifier_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_POINTER
*
* Return value:
* A valid pointer to an NSSPKIXAlgorithmIdentifier upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAlgorithmIdentifier *
nssPKIXAlgorithmIdentifier_Create
(
NSSArena *arenaOpt,
NSSOID *algorithm,
NSSItem *parameters
);
/*
* nssPKIXAlgorithmIdentifier_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAlgorithmIdentifier_Destroy
(
NSSPKIXAlgorithmIdentifier *algid
);
/*
* nssPKIXAlgorithmIdentifier_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXAlgorithmIdentifier_Encode
(
NSSPKIXAlgorithmIdentifier *algid,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXAlgorithmIdentifier_GetAlgorithm
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSOID pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSOID *
nssPKIXAlgorithmIdentifier_GetAlgorithm
(
NSSPKIXAlgorithmIdentifier *algid
);
/*
* nssPKIXAlgorithmIdentifier_SetAlgorithm
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
* NSS_ERROR_INVALID_OID
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAlgorithmIdentifier_SetAlgorithm
(
NSSPKIXAlgorithmIdentifier *algid,
NSSOID *algorithm
);
/*
* nssPKIXAlgorithmIdentifier_GetParameters
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSItem upon success
* NULL upon failure
*/
NSS_EXTERN NSSItem *
nssPKIXAlgorithmIdentifier_GetParameters
(
NSSPKIXAlgorithmIdentifier *algid,
NSSItem *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXAlgorithmIdentifier_SetParameters
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
* NSS_ERROR_INVALID_POINTER
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAlgorithmIdentifier_SetParameters
(
NSSPKIXAlgorithmIdentifier *algid,
NSSItem *parameters
);
/*
* nssPKIXAlgorithmIdentifier_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXAlgorithmIdentifier_Equal
(
NSSPKIXAlgorithmIdentifier *algid1,
NSSPKIXAlgorithmIdentifier *algid2,
PRStatus *statusOpt
);
/*
* nssPKIXAlgorithmIdentifier_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXAlgorithmIdentifier upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAlgorithmIdentifier *
nssPKIXAlgorithmIdentifier_Duplicate
(
NSSPKIXAlgorithmIdentifier *algid,
NSSArena *arenaOpt
);
/*
* { algorithm-specific parameter types and accessors ? }
*/
#ifdef DEBUG
/*
* nssPKIXAlgorithmIdentifier_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXAlgorithmIdentifier
* 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_ALGORITHM_IDENTIFIER
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXAlgorithmIdentifier_verifyPointer
(
NSSPKIXAlgorithmIdentifier *p
);
#endif /* DEBUG */
/*
* ORAddress
*
* -- fgmr comments --
*
* From RFC 2459:
*
* ORAddress ::= SEQUENCE {
* built-in-standard-attributes BuiltInStandardAttributes,
* built-in-domain-defined-attributes
* BuiltInDomainDefinedAttributes OPTIONAL,
* -- see also teletex-domain-defined-attributes
* extension-attributes ExtensionAttributes OPTIONAL }
* -- The OR-address is semantically absent from the OR-name if the
* -- built-in-standard-attribute sequence is empty and the
* -- built-in-domain-defined-attributes and extension-attributes are
* -- both omitted.
*
* The private calls for this type:
*
* nssPKIXORAddress_Decode
* nssPKIXORAddress_Create
* nssPKIXORAddress_Destroy
* nssPKIXORAddress_Encode
* nssPKIXORAddress_GetBuiltInStandardAttributes
* nssPKIXORAddress_SetBuiltInStandardAttributes
* nssPKIXORAddress_HasBuiltInDomainDefinedAttributes
* nssPKIXORAddress_GetBuiltInDomainDefinedAttributes
* nssPKIXORAddress_SetBuiltInDomainDefinedAttributes
* nssPKIXORAddress_RemoveBuiltInDomainDefinedAttributes
* nssPKIXORAddress_HasExtensionsAttributes
* nssPKIXORAddress_GetExtensionsAttributes
* nssPKIXORAddress_SetExtensionsAttributes
* nssPKIXORAddress_RemoveExtensionsAttributes
* nssPKIXORAddress_Equal
* nssPKIXORAddress_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXORAddress_verifyPointer
*
*/
/*
* nssPKIXORAddress_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 NSSPKIXORAddres upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXORAddress *
nssPKIXORAddress_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXORAddress_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_PKIX_EXTENSIONS_ATTRIBUTES
*
* Return value:
* A valid pointer to an NSSPKIXORAddres upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXORAddress *
nssPKIXORAddress_Create
(
NSSArena *arenaOpt,
NSSPKIXBuiltInStandardAttributes *bisa,
NSSPKIXBuiltInDomainDefinedAttributes *biddaOpt,
NSSPKIXExtensionAttributes *eaOpt
);
/*
* nssPKIXORAddress_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_OR_ADDRESS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXORAddress_Destroy
(
NSSPKIXORAddress *ora
);
/*
* nssPKIXORAddress_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_OR_ADDRESS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXORAddress_Encode
(
NSSPKIXORAddress *ora,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXORAddress_GetBuiltInStandardAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_OR_ADDRESS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXBuiltInStandardAttributes upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBuiltInStandardAttributes *
nssPKIXORAddress_GetBuiltInStandardAttributes
(
NSSPKIXORAddress *ora,
NSSArena *arenaOpt
);
/*
* nssPKIXORAddress_SetBuiltInStandardAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_OR_ADDRESS
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXORAddress_SetBuiltInStandardAttributes
(
NSSPKIXORAddress *ora,
NSSPKIXBuiltInStandardAttributes *bisa
);
/*
* nssPKIXORAddress_HasBuiltInDomainDefinedAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_OR_ADDRESS
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXORAddress_HasBuiltInDomainDefinedAttributes
(
NSSPKIXORAddress *ora,
PRStatus *statusOpt
);
/*
* nssPKIXORAddress_GetBuiltInDomainDefinedAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_OR_ADDRESS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_NO_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
*
* Return value:
* A valid pointer to an NSSPKIXBuiltInDomainDefinedAttributes upon
* success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBuiltInDomainDefinedAttributes *
nssPKIXORAddress_GetBuiltInDomainDefinedAttributes
(
NSSPKIXORAddress *ora,
NSSArena *arenaOpt
);
/*
* nssPKIXORAddress_SetBuiltInDomainDefinedAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_OR_ADDRESS
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXORAddress_SetBuiltInDomainDefinedAttributes
(
NSSPKIXORAddress *ora,
NSSPKIXBuiltInStandardAttributes *bisa
);
/*
* nssPKIXORAddress_RemoveBuiltInDomainDefinedAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_OR_ADDRESS
* NSS_ERROR_NO_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXORAddress_RemoveBuiltInDomainDefinedAttributes
(
NSSPKIXORAddress *ora
);
/*
* nssPKIXORAddress_HasExtensionsAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_OR_ADDRESS
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXORAddress_HasExtensionsAttributes
(
NSSPKIXORAddress *ora,
PRStatus *statusOpt
);
/*
* nssPKIXORAddress_GetExtensionsAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_OR_ADDRESS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_NO_EXTENSION_ATTRIBUTES
*
* Return value:
* A valid pointer to an NSSPKIXExtensionAttributes upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtensionAttributes *
nssPKIXORAddress_GetExtensionsAttributes
(
NSSPKIXORAddress *ora,
NSSArena *arenaOpt
);
/*
* nssPKIXORAddress_SetExtensionsAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_OR_ADDRESS
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXORAddress_SetExtensionsAttributes
(
NSSPKIXORAddress *ora,
NSSPKIXExtensionAttributes *eaOpt
);
/*
* nssPKIXORAddress_RemoveExtensionsAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_OR_ADDRESS
* NSS_ERROR_NO_EXTENSION_ATTRIBUTES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXORAddress_RemoveExtensionsAttributes
(
NSSPKIXORAddress *ora
);
/*
* nssPKIXORAddress_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_OR_ADDRESS
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXORAddress_Equal
(
NSSPKIXORAddress *ora1,
NSSPKIXORAddress *ora2,
PRStatus *statusOpt
);
/*
* nssPKIXORAddress_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_OR_ADDRESS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXORAddres upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXORAddress *
nssPKIXORAddress_Duplicate
(
NSSPKIXORAddress *ora,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXORAddress_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXORAddress
* 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_OR_ADDRESS
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXORAddress_verifyPointer
(
NSSPKIXORAddress *p
);
#endif /* DEBUG */
/*
* BuiltInStandardAttributes
*
* -- fgmr comments --
*
* From RFC 2459:
*
* BuiltInStandardAttributes ::= SEQUENCE {
* country-name CountryName OPTIONAL,
* administration-domain-name AdministrationDomainName OPTIONAL,
* network-address [0] NetworkAddress OPTIONAL,
* -- see also extended-network-address
* terminal-identifier [1] TerminalIdentifier OPTIONAL,
* private-domain-name [2] PrivateDomainName OPTIONAL,
* organization-name [3] OrganizationName OPTIONAL,
* -- see also teletex-organization-name
* numeric-user-identifier [4] NumericUserIdentifier OPTIONAL,
* personal-name [5] PersonalName OPTIONAL,
* -- see also teletex-personal-name
* organizational-unit-names [6] OrganizationalUnitNames OPTIONAL
* -- see also teletex-organizational-unit-names -- }
*
* The private calls for this type:
*
* nssPKIXBuiltInStandardAttributes_Decode
* nssPKIXBuiltInStandardAttributes_Create
* nssPKIXBuiltInStandardAttributes_Destroy
* nssPKIXBuiltInStandardAttributes_Encode
* nssPKIXBuiltInStandardAttributes_HasCountryName
* nssPKIXBuiltInStandardAttributes_GetCountryName
* nssPKIXBuiltInStandardAttributes_SetCountryName
* nssPKIXBuiltInStandardAttributes_RemoveCountryName
* nssPKIXBuiltInStandardAttributes_HasAdministrationDomainName
* nssPKIXBuiltInStandardAttributes_GetAdministrationDomainName
* nssPKIXBuiltInStandardAttributes_SetAdministrationDomainName
* nssPKIXBuiltInStandardAttributes_RemoveAdministrationDomainName
* nssPKIXBuiltInStandardAttributes_HasNetworkAddress
* nssPKIXBuiltInStandardAttributes_GetNetworkAddress
* nssPKIXBuiltInStandardAttributes_SetNetworkAddress
* nssPKIXBuiltInStandardAttributes_RemoveNetworkAddress
* nssPKIXBuiltInStandardAttributes_HasTerminalIdentifier
* nssPKIXBuiltInStandardAttributes_GetTerminalIdentifier
* nssPKIXBuiltInStandardAttributes_SetTerminalIdentifier
* nssPKIXBuiltInStandardAttributes_RemoveTerminalIdentifier
* nssPKIXBuiltInStandardAttributes_HasPrivateDomainName
* nssPKIXBuiltInStandardAttributes_GetPrivateDomainName
* nssPKIXBuiltInStandardAttributes_SetPrivateDomainName
* nssPKIXBuiltInStandardAttributes_RemovePrivateDomainName
* nssPKIXBuiltInStandardAttributes_HasOrganizationName
* nssPKIXBuiltInStandardAttributes_GetOrganizationName
* nssPKIXBuiltInStandardAttributes_SetOrganizationName
* nssPKIXBuiltInStandardAttributes_RemoveOrganizationName
* nssPKIXBuiltInStandardAttributes_HasNumericUserIdentifier
* nssPKIXBuiltInStandardAttributes_GetNumericUserIdentifier
* nssPKIXBuiltInStandardAttributes_SetNumericUserIdentifier
* nssPKIXBuiltInStandardAttributes_RemoveNumericUserIdentifier
* nssPKIXBuiltInStandardAttributes_HasPersonalName
* nssPKIXBuiltInStandardAttributes_GetPersonalName
* nssPKIXBuiltInStandardAttributes_SetPersonalName
* nssPKIXBuiltInStandardAttributes_RemovePersonalName
* nssPKIXBuiltInStandardAttributes_HasOrganizationLUnitNames
* nssPKIXBuiltInStandardAttributes_GetOrganizationLUnitNames
* nssPKIXBuiltInStandardAttributes_SetOrganizationLUnitNames
* nssPKIXBuiltInStandardAttributes_RemoveOrganizationLUnitNames
* nssPKIXBuiltInStandardAttributes_Equal
* nssPKIXBuiltInStandardAttributes_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXBuiltInStandardAttributes_verifyPointer
*
*/
/*
* nssPKIXBuiltInStandardAttributes_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 NSSPKIXBuiltInStandardAttributes upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBuiltInStandardAttributes *
nssPKIXBuiltInStandardAttributes_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXBuiltInStandardAttributes_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_COUNTRY_NAME
* NSS_ERROR_INVALID_PKIX_ADMINISTRATION_DOMAIN_NAME
* NSS_ERROR_INVALID_PKIX_NETWORK_ADDRESS
* NSS_ERROR_INVALID_PKIX_TERMINAL_IDENTIFIER
* NSS_ERROR_INVALID_PKIX_PRIVATE_DOMAIN_NAME
* NSS_ERROR_INVALID_PKIX_ORGANIZATION_NAME
* NSS_ERROR_INVALID_PKIX_NUMERIC_USER_IDENTIFIER
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
*
* Return value:
* A valid pointer to an NSSPKIXBuiltInStandardAttributes upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBuiltInStandardAttributes *
nssPKIXBuiltInStandardAttributes_Create
(
NSSArena *arenaOpt,
NSSPKIXCountryName *countryNameOpt,
NSSPKIXAdministrationDomainName *administrationDomainNameOpt,
NSSPKIXNetworkAddress *networkAddressOpt,
NSSPKIXTerminalIdentifier *terminalIdentifierOpt,
NSSPKIXPrivateDomainName *privateDomainNameOpt,
NSSPKIXOrganizationName *organizationNameOpt,
NSSPKIXNumericUserIdentifier *numericUserIdentifierOpt,
NSSPKIXPersonalName *personalNameOpt,
NSSPKIXOrganizationalUnitNames *organizationalUnitNamesOpt
);
/*
* nssPKIXBuiltInStandardAttributes_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_Destroy
(
NSSPKIXBuiltInStandardAttributes *bisa
);
/*
* nssPKIXBuiltInStandardAttributes_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXBuiltInStandardAttributes_Encode
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInStandardAttributes_HasCountryName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXBuiltInStandardAttributes_HasCountryName
(
NSSPKIXBuiltInStandardAttributes *bisa,
PRStatus *statusOpt
);
/*
* nssPKIXBuiltInStandardAttributes_GetCountryName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXCountryName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXCountryName *
nssPKIXBuiltInStandardAttributes_GetCountryName
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInStandardAttributes_SetCountryName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_COUNTRY_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_SetCountryName
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSPKIXCountryName *countryName
);
/*
* nssPKIXBuiltInStandardAttributes_RemoveCountryName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_COUNTRY_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_RemoveCountryName
(
NSSPKIXBuiltInStandardAttributes *bisa
);
/*
* nssPKIXBuiltInStandardAttributes_HasAdministrationDomainName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXBuiltInStandardAttributes_HasAdministrationDomainName
(
NSSPKIXBuiltInStandardAttributes *bisa,
PRStatus *statusOpt
);
/*
* nssPKIXBuiltInStandardAttributes_GetAdministrationDomainName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXAdministrationDomainName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAdministrationDomainName *
nssPKIXBuiltInStandardAttributes_GetAdministrationDomainName
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInStandardAttributes_SetAdministrationDomainName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_ADMINISTRATION_DOMAIN_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_SetAdministrationDomainName
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSPKIXAdministrationDomainName *administrationDomainName
);
/*
* nssPKIXBuiltInStandardAttributes_RemoveAdministrationDomainName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_ADMINISTRATION_DOMAIN_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_RemoveAdministrationDomainName
(
NSSPKIXBuiltInStandardAttributes *bisa
);
/*
* nssPKIXBuiltInStandardAttributes_HasNetworkAddress
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXBuiltInStandardAttributes_HasNetworkAddress
(
NSSPKIXBuiltInStandardAttributes *bisa,
PRStatus *statusOpt
);
/*
* nssPKIXBuiltInStandardAttributes_GetNetworkAddress
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXNetworkAddress upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXNetworkAddress *
nssPKIXBuiltInStandardAttributes_GetNetworkAddress
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInStandardAttributes_SetNetworkAddress
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_NETWORK_ADDRESS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_SetNetworkAddress
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSPKIXNetworkAddress *networkAddress
);
/*
* nssPKIXBuiltInStandardAttributes_RemoveNetworkAddress
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_NETWORK_ADDRESS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_RemoveNetworkAddress
(
NSSPKIXBuiltInStandardAttributes *bisa
);
/*
* nssPKIXBuiltInStandardAttributes_HasTerminalIdentifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXBuiltInStandardAttributes_HasTerminalIdentifier
(
NSSPKIXBuiltInStandardAttributes *bisa,
PRStatus *statusOpt
);
/*
* nssPKIXBuiltInStandardAttributes_GetTerminalIdentifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXTerminalIdentifier upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTerminalIdentifier *
nssPKIXBuiltInStandardAttributes_GetTerminalIdentifier
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInStandardAttributes_SetTerminalIdentifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_TERMINAL_IDENTIFIER
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_SetTerminalIdentifier
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSPKIXTerminalIdentifier *terminalIdentifier
);
/*
* nssPKIXBuiltInStandardAttributes_RemoveTerminalIdentifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_TERMINAL_IDENTIFIER
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_RemoveTerminalIdentifier
(
NSSPKIXBuiltInStandardAttributes *bisa
);
/*
* nssPKIXBuiltInStandardAttributes_HasPrivateDomainName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXBuiltInStandardAttributes_HasPrivateDomainName
(
NSSPKIXBuiltInStandardAttributes *bisa,
PRStatus *statusOpt
);
/*
* nssPKIXBuiltInStandardAttributes_GetPrivateDomainName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXPrivateDomainName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPrivateDomainName *
nssPKIXBuiltInStandardAttributes_GetPrivateDomainName
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInStandardAttributes_SetPrivateDomainName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_PRIVATE_DOMAIN_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_SetPrivateDomainName
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSPKIXPrivateDomainName *privateDomainName
);
/*
* nssPKIXBuiltInStandardAttributes_RemovePrivateDomainName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_PRIVATE_DOMAIN_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_RemovePrivateDomainName
(
NSSPKIXBuiltInStandardAttributes *bisa
);
/*
* nssPKIXBuiltInStandardAttributes_HasOrganizationName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXBuiltInStandardAttributes_HasOrganizationName
(
NSSPKIXBuiltInStandardAttributes *bisa,
PRStatus *statusOpt
);
/*
* nssPKIXBuiltInStandardAttributes_GetOrganizationName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXOrganizationName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXOrganizationName *
nssPKIXBuiltInStandardAttributes_GetOrganizationName
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInStandardAttributes_SetOrganizationName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_ORGANIZATION_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_SetOrganizationName
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSPKIXOrganizationName *organizationName
);
/*
* nssPKIXBuiltInStandardAttributes_RemoveOrganizationName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_ORGANIZATION_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_RemoveOrganizationName
(
NSSPKIXBuiltInStandardAttributes *bisa
);
/*
* nssPKIXBuiltInStandardAttributes_HasNumericUserIdentifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXBuiltInStandardAttributes_HasNumericUserIdentifier
(
NSSPKIXBuiltInStandardAttributes *bisa,
PRStatus *statusOpt
);
/*
* nssPKIXBuiltInStandardAttributes_GetNumericUserIdentifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXNumericUserIdentifier upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXNumericUserIdentifier *
nssPKIXBuiltInStandardAttributes_GetNumericUserIdentifier
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInStandardAttributes_SetNumericUserIdentifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_NUMERIC_USER_IDENTIFIER
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_SetNumericUserIdentifier
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSPKIXNumericUserIdentifier *numericUserIdentifier
);
/*
* nssPKIXBuiltInStandardAttributes_RemoveNumericUserIdentifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_NUMERIC_USER_IDENTIFIER
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_RemoveNumericUserIdentifier
(
NSSPKIXBuiltInStandardAttributes *bisa
);
/*
* nssPKIXBuiltInStandardAttributes_HasPersonalName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXBuiltInStandardAttributes_HasPersonalName
(
NSSPKIXBuiltInStandardAttributes *bisa,
PRStatus *statusOpt
);
/*
* nssPKIXBuiltInStandardAttributes_GetPersonalName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXPersonalName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPersonalName *
nssPKIXBuiltInStandardAttributes_GetPersonalName
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInStandardAttributes_SetPersonalName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_SetPersonalName
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSPKIXPersonalName *personalName
);
/*
* nssPKIXBuiltInStandardAttributes_RemovePersonalName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_PERSONAL_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_RemovePersonalName
(
NSSPKIXBuiltInStandardAttributes *bisa
);
/*
* nssPKIXBuiltInStandardAttributes_HasOrganizationLUnitNames
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXBuiltInStandardAttributes_HasOrganizationLUnitNames
(
NSSPKIXBuiltInStandardAttributes *bisa,
PRStatus *statusOpt
);
/*
* nssPKIXBuiltInStandardAttributes_GetOrganizationLUnitNames
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXOrganizationalUnitNames upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXOrganizationalUnitNames *
nssPKIXBuiltInStandardAttributes_GetOrganizationLUnitNames
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInStandardAttributes_SetOrganizationLUnitNames
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_SetOrganizationLUnitNames
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSPKIXOrganizationalUnitNames *organizationalUnitNames
);
/*
* nssPKIXBuiltInStandardAttributes_RemoveOrganizationLUnitNames
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_ORGANIZATIONAL_UNIT_NAMES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_RemoveOrganizationLUnitNames
(
NSSPKIXBuiltInStandardAttributes *bisa
);
/*
* nssPKIXBuiltInStandardAttributes_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXBuiltInStandardAttributes_Equal
(
NSSPKIXBuiltInStandardAttributes *bisa1,
NSSPKIXBuiltInStandardAttributes *bisa2,
PRStatus *statusOpt
);
/*
* nssPKIXBuiltInStandardAttributes_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXBuiltInStandardAttributes upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBuiltInStandardAttributes *
nssPKIXBuiltInStandardAttributes_Duplicate
(
NSSPKIXBuiltInStandardAttributes *bisa,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXBuiltInStandardAttributes_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXBuiltInStandardAttributes
* 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_BUILT_IN_STANDARD_ATTRIBUTES
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInStandardAttributes_verifyPointer
(
NSSPKIXBuiltInStandardAttributes *p
);
#endif /* DEBUG */
/*
* CountryName
*
* -- fgmr comments --
*
* From RFC 2459:
*
* CountryName ::= [APPLICATION 1] CHOICE {
* x121-dcc-code NumericString
* (SIZE (ub-country-name-numeric-length)),
* iso-3166-alpha2-code PrintableString
* (SIZE (ub-country-name-alpha-length)) }
*
* The private calls for this type:
*
* nssPKIXCountryName_Decode
* nssPKIXCountryName_CreateFromUTF8
* nssPKIXCountryName_Encode
*
*/
/*
* nssPKIXCountryName_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 NSSPKIXCountryName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXCountryName *
nssPKIXCountryName_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXCountryName_CreateFromUTF8
*
* { basically just enforces the length limit }
*
* 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 NSSPKIXCountryName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXCountryName *
nssPKIXCountryName_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXCountryName_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_COUNTRY_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXCountryName_Encode
(
NSSPKIXCountryName *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* AdministrationDomainName
*
* -- fgmr comments --
*
* From RFC 2459:
*
* AdministrationDomainName ::= [APPLICATION 2] CHOICE {
* numeric NumericString (SIZE (0..ub-domain-name-length)),
* printable PrintableString (SIZE (0..ub-domain-name-length)) }
*
* The private calls for this type:
*
* nssPKIXAdministrationDomainName_Decode
* nssPKIXAdministrationDomainName_CreateFromUTF8
* nssPKIXAdministrationDomainName_Encode
*
*/
/*
* nssPKIXAdministrationDomainName_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 NSSPKIXAdministrationDomainName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAdministrationDomainName *
nssPKIXAdministrationDomainName_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXAdministrationDomainName_CreateFromUTF8
*
* { basically just enforces the length limit }
*
* 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 NSSPKIXAdministrationDomainName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAdministrationDomainName *
nssPKIXAdministrationDomainName_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXAdministrationDomainName_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ADMINISTRATION_DOMAIN_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXAdministrationDomainName_Encode
(
NSSPKIXAdministrationDomainName *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* X121Address
*
* -- fgmr comments --
*
* From RFC 2459:
*
* X121Address ::= NumericString (SIZE (1..ub-x121-address-length))
*
* The private calls for this type:
*
* nssPKIXX121Address_Decode
* nssPKIXX121Address_CreateFromUTF8
* nssPKIXX121Address_Encode
*
*/
/*
* nssPKIXX121Address_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 NSSPKIXX121Address upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXX121Address *
nssPKIXX121Address_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXX121Address_CreateFromUTF8
*
* { basically just enforces the length limit }
*
* 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 NSSPKIXX121Address upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXX121Address *
nssPKIXX121Address_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXX121Address_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_X121_ADDRESS
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXX121Address_Encode
(
NSSPKIXX121Address *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* NetworkAddress
*
* -- fgmr comments --
*
* From RFC 2459:
*
* NetworkAddress ::= X121Address -- see also extended-network-address
*
* The private calls for this type:
*
* nssPKIXNetworkAddress_Decode
* nssPKIXNetworkAddress_CreateFromUTF8
* nssPKIXNetworkAddress_Encode
*
*/
/*
* nssPKIXNetworkAddress_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 NSSPKIXNetworkAddress upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXNetworkAddress *
nssPKIXNetworkAddress_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXNetworkAddress_CreateFromUTF8
*
* { basically just enforces the length limit }
*
* 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 NSSPKIXNetworkAddress upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXNetworkAddress *
nssPKIXNetworkAddress_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXNetworkAddress_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_NETWORK_ADDRESS
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXNetworkAddress_Encode
(
NSSPKIXNetworkAddress *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* TerminalIdentifier
*
* -- fgmr comments --
*
* From RFC 2459:
*
* TerminalIdentifier ::= PrintableString (SIZE (1..ub-terminal-id-length))
*
* The private calls for this type:
*
* nssPKIXTerminalIdentifier_Decode
* nssPKIXTerminalIdentifier_CreateFromUTF8
* nssPKIXTerminalIdentifier_Encode
*
*/
/*
* nssPKIXTerminalIdentifier_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 NSSPKIXTerminalIdentifier upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTerminalIdentifier *
nssPKIXTerminalIdentifier_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXTerminalIdentifier_CreateFromUTF8
*
* { basically just enforces the length limit }
*
* 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 NSSPKIXTerminalIdentifier upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTerminalIdentifier *
nssPKIXTerminalIdentifier_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXTerminalIdentifier_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TERMINAL_IDENTIFIER
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXTerminalIdentifier_Encode
(
NSSPKIXTerminalIdentifier *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* PrivateDomainName
*
* -- fgmr comments --
*
* PrivateDomainName ::= CHOICE {
* numeric NumericString (SIZE (1..ub-domain-name-length)),
* printable PrintableString (SIZE (1..ub-domain-name-length)) }
*
* The private calls for this type:
*
* nssPKIXPrivateDomainName_Decode
* nssPKIXPrivateDomainName_CreateFromUTF8
* nssPKIXPrivateDomainName_Encode
*
*/
/*
* nssPKIXPrivateDomainName_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 NSSPKIXPrivateDomainName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPrivateDomainName *
nssPKIXPrivateDomainName_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXPrivateDomainName_CreateFromUTF8
*
* { basically just enforces the length limit }
*
* 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 NSSPKIXPrivateDomainName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPrivateDomainName *
nssPKIXPrivateDomainName_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXPrivateDomainName_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PRIVATE_DOMAIN_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXPrivateDomainName_Encode
(
NSSPKIXPrivateDomainName *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* OrganizationName
*
* -- fgmr comments --
*
* OrganizationName ::= PrintableString
* (SIZE (1..ub-organization-name-length))
*
* The private calls for this type:
*
* nssPKIXOrganizationName_Decode
* nssPKIXOrganizationName_CreateFromUTF8
* nssPKIXOrganizationName_Encode
*
*/
/*
* nssPKIXOrganizationName_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 NSSPKIXOrganizationName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXOrganizationName *
nssPKIXOrganizationName_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXOrganizationName_CreateFromUTF8
*
* { basically just enforces the length limit }
*
* 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 NSSPKIXOrganizationName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXOrganizationName *
nssPKIXOrganizationName_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXOrganizationName_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ORGANIZATION_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXOrganizationName_Encode
(
NSSPKIXOrganizationName *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* NumericUserIdentifier
*
* -- fgmr comments --
*
* From RFC 2459:
*
* NumericUserIdentifier ::= NumericString
* (SIZE (1..ub-numeric-user-id-length))
*
* The private calls for this type:
*
* nssPKIXNumericUserIdentifier_Decode
* nssPKIXNumericUserIdentifier_CreateFromUTF8
* nssPKIXNumericUserIdentifier_Encode
*
*/
/*
* nssPKIXNumericUserIdentifier_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 NSSPKIXNumericUserIdentifier upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXNumericUserIdentifier *
nssPKIXNumericUserIdentifier_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXNumericUserIdentifier_CreateFromUTF8
*
* { basically just enforces the length limit }
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_UTF8
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXNumericUserIdentifier upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXNumericUserIdentifier *
nssPKIXNumericUserIdentifier_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXNumericUserIdentifier_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_NUMERIC_USER_IDENTIFIER
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXNumericUserIdentifier_Encode
(
NSSPKIXNumericUserIdentifier *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* PersonalName
*
* -- fgmr comments --
*
* From RFC 2459:
*
* PersonalName ::= SET {
* surname [0] PrintableString (SIZE (1..ub-surname-length)),
* given-name [1] PrintableString
* (SIZE (1..ub-given-name-length)) OPTIONAL,
* initials [2] PrintableString (SIZE (1..ub-initials-length)) OPTIONAL,
* generation-qualifier [3] PrintableString
* (SIZE (1..ub-generation-qualifier-length)) OPTIONAL }
*
* The private calls for this type:
*
* nssPKIXPersonalName_Decode
* nssPKIXPersonalName_Create
* nssPKIXPersonalName_Destroy
* nssPKIXPersonalName_Encode
* nssPKIXPersonalName_GetSurname
* nssPKIXPersonalName_SetSurname
* nssPKIXPersonalName_HasGivenName
* nssPKIXPersonalName_GetGivenName
* nssPKIXPersonalName_SetGivenName
* nssPKIXPersonalName_RemoveGivenName
* nssPKIXPersonalName_HasInitials
* nssPKIXPersonalName_GetInitials
* nssPKIXPersonalName_SetInitials
* nssPKIXPersonalName_RemoveInitials
* nssPKIXPersonalName_HasGenerationQualifier
* nssPKIXPersonalName_GetGenerationQualifier
* nssPKIXPersonalName_SetGenerationQualifier
* nssPKIXPersonalName_RemoveGenerationQualifier
* nssPKIXPersonalName_Equal
* nssPKIXPersonalName_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXPersonalName_verifyPointer
*
*/
/*
* nssPKIXPersonalName_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 NSSPKIXPersonalName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPersonalName *
nssPKIXPersonalName_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXPersonalName_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_STRING
*
* Return value:
* A valid pointer to an NSSPKIXPersonalName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPersonalName *
nssPKIXPersonalName_Create
(
NSSArena *arenaOpt,
NSSUTF8 *surname,
NSSUTF8 *givenNameOpt,
NSSUTF8 *initialsOpt,
NSSUTF8 *generationQualifierOpt
);
/*
* nssPKIXPersonalName_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPersonalName_Destroy
(
NSSPKIXPersonalName *personalName
);
/*
* nssPKIXPersonalName_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXPersonalName_Encode
(
NSSPKIXPersonalName *personalName,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXPersonalName_GetSurname
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSUTF8 upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXPersonalName_GetSurname
(
NSSPKIXPersonalName *personalName,
NSSArena *arenaOpt
);
/*
* nssPKIXPersonalName_SetSurname
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
* NSS_ERROR_INVALID_STRING
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPersonalName_SetSurname
(
NSSPKIXPersonalName *personalName,
NSSUTF8 *surname
);
/*
* nssPKIXPersonalName_HasGivenName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXPersonalName_HasGivenName
(
NSSPKIXPersonalName *personalName,
PRStatus *statusOpt
);
/*
* nssPKIXPersonalName_GetGivenName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_HAS_NO_GIVEN_NAME
*
* Return value:
* A valid pointer to an NSSUTF8 upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXPersonalName_GetGivenName
(
NSSPKIXPersonalName *personalName,
NSSArena *arenaOpt
);
/*
* nssPKIXPersonalName_SetGivenName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
* NSS_ERROR_INVALID_STRING
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPersonalName_SetGivenName
(
NSSPKIXPersonalName *personalName,
NSSUTF8 *givenName
);
/*
* nssPKIXPersonalName_RemoveGivenName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
* NSS_ERROR_HAS_NO_GIVEN_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPersonalName_RemoveGivenName
(
NSSPKIXPersonalName *personalName
);
/*
* nssPKIXPersonalName_HasInitials
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXPersonalName_HasInitials
(
NSSPKIXPersonalName *personalName,
PRStatus *statusOpt
);
/*
* nssPKIXPersonalName_GetInitials
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
*
* Return value:
* A valid pointer to an NSSUTF8 upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXPersonalName_GetInitials
(
NSSPKIXPersonalName *personalName,
NSSArena *arenaOpt
);
/*
* nssPKIXPersonalName_SetInitials
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
* NSS_ERROR_INVALID_STRING
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPersonalName_SetInitials
(
NSSPKIXPersonalName *personalName,
NSSUTF8 *initials
);
/*
* nssPKIXPersonalName_RemoveInitials
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPersonalName_RemoveInitials
(
NSSPKIXPersonalName *personalName
);
/*
* nssPKIXPersonalName_HasGenerationQualifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXPersonalName_HasGenerationQualifier
(
NSSPKIXPersonalName *personalName,
PRStatus *statusOpt
);
/*
* nssPKIXPersonalName_GetGenerationQualifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
*
* Return value:
* A valid pointer to an NSSUTF8 upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXPersonalName_GetGenerationQualifier
(
NSSPKIXPersonalName *personalName,
NSSArena *arenaOpt
);
/*
* nssPKIXPersonalName_SetGenerationQualifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
* NSS_ERROR_INVALID_STRING
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPersonalName_SetGenerationQualifier
(
NSSPKIXPersonalName *personalName,
NSSUTF8 *generationQualifier
);
/*
* nssPKIXPersonalName_RemoveGenerationQualifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPersonalName_RemoveGenerationQualifier
(
NSSPKIXPersonalName *personalName
);
/*
* nssPKIXPersonalName_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXPersonalName_Equal
(
NSSPKIXPersonalName *personalName1,
NSSPKIXPersonalName *personalName2,
PRStatus *statusOpt
);
/*
* nssPKIXPersonalName_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
*
* Return value:
* A valid pointer to an NSSPKIXPersonalName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPersonalName *
nssPKIXPersonalName_Duplicate
(
NSSPKIXPersonalName *personalName,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXPersonalName_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXPersonalName
* 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_PERSONAL_NAME
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXPersonalName_verifyPointer
(
NSSPKIXPersonalName *p
);
#endif /* DEBUG */
/*
* OrganizationalUnitNames
*
* -- fgmr comments --
*
* From RFC 2459:
*
* OrganizationalUnitNames ::= SEQUENCE SIZE (1..ub-organizational-units)
* OF OrganizationalUnitName
*
* The private calls for the type:
*
* nssPKIXOrganizationalUnitNames_Decode
* nssPKIXOrganizationalUnitNames_Create
* nssPKIXOrganizationalUnitNames_Destroy
* nssPKIXOrganizationalUnitNames_Encode
* nssPKIXOrganizationalUnitNames_GetOrganizationalUnitNameCount
* nssPKIXOrganizationalUnitNames_GetOrganizationalUnitNames
* nssPKIXOrganizationalUnitNames_SetOrganizationalUnitNames
* nssPKIXOrganizationalUnitNames_GetOrganizationalUnitName
* nssPKIXOrganizationalUnitNames_SetOrganizationalUnitName
* nssPKIXOrganizationalUnitNames_InsertOrganizationalUnitName
* nssPKIXOrganizationalUnitNames_AppendOrganizationalUnitName
* nssPKIXOrganizationalUnitNames_RemoveOrganizationalUnitName
* nssPKIXOrganizationalUnitNames_FindOrganizationalUnitName
* nssPKIXOrganizationalUnitNames_Equal
* nssPKIXOrganizationalUnitNames_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXOrganizationalUnitNames_verifyPointer
*
*/
/*
* nssPKIXOrganizationalUnitNames_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 NSSPKIXOrganizationalUnitNames upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXOrganizationalUnitNames *
nssPKIXOrganizationalUnitNames_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXOrganizationalUnitNames_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAME
*
* Return value:
* A valid pointer to an NSSPKIXOrganizationalUnitNames upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXOrganizationalUnitNames *
nssPKIXOrganizationalUnitNames_Create
(
NSSArena *arenaOpt,
NSSPKIXOrganizationalUnitName *ou1,
...
);
/*
* nssPKIXOrganizationalUnitNames_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXOrganizationalUnitNames_Destroy
(
NSSPKIXOrganizationalUnitNames *ous
);
/*
* nssPKIXOrganizationalUnitNames_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXOrganizationalUnitNames_Encode
(
NSSPKIXOrganizationalUnitNames *ous,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXOrganizationalUnitNames_GetOrganizationalUnitNameCount
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXOrganizationalUnitNames_GetOrganizationalUnitNameCount
(
NSSPKIXOrganizationalUnitNames *ous
);
/*
* nssPKIXOrganizationalUnitNames_GetOrganizationalUnitNames
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_ARRAY_TOO_SMALL
*
* Return value:
* A valid pointer to an array of NSSPKIXOrganizationalUnitName
* pointers upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXOrganizationalUnitName **
nssPKIXOrganizationalUnitNames_GetOrganizationalUnitNames
(
NSSPKIXOrganizationalUnitNames *ous,
NSSPKIXOrganizationalUnitName *rvOpt[],
PRInt32 limit,
NSSArena *arenaOpt
);
/*
* nssPKIXOrganizationalUnitNames_SetOrganizationalUnitNames
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXOrganizationalUnitNames_SetOrganizationalUnitNames
(
NSSPKIXOrganizationalUnitNames *ous,
NSSPKIXOrganizationalUnitName *ou[],
PRInt32 count
);
/*
* nssPKIXOrganizationalUnitNames_GetOrganizationalUnitName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXOrganizationalUnitName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXOrganizationalUnitName *
nssPKIXOrganizationalUnitNames_GetOrganizationalUnitName
(
NSSPKIXOrganizationalUnitNames *ous,
PRInt32 i,
NSSArena *arenaOpt
);
/*
* nssPKIXOrganizationalUnitNames_SetOrganizationalUnitName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAME
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXOrganizationalUnitNames_SetOrganizationalUnitName
(
NSSPKIXOrganizationalUnitNames *ous,
PRInt32 i,
NSSPKIXOrganizationalUnitName *ou
);
/*
* nssPKIXOrganizationalUnitNames_InsertOrganizationalUnitName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAME
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXOrganizationalUnitNames_InsertOrganizationalUnitName
(
NSSPKIXOrganizationalUnitNames *ous,
PRInt32 i,
NSSPKIXOrganizationalUnitName *ou
);
/*
* nssPKIXOrganizationalUnitNames_AppendOrganizationalUnitName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXOrganizationalUnitNames_AppendOrganizationalUnitName
(
NSSPKIXOrganizationalUnitNames *ous,
NSSPKIXOrganizationalUnitName *ou
);
/*
* nssPKIXOrganizationalUnitNames_RemoveOrganizationalUnitName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXOrganizationalUnitNames_RemoveOrganizationalUnitName
(
NSSPKIXOrganizationalUnitNames *ous,
PRInt32 i
);
/*
* nssPKIXOrganizationalUnitNames_FindOrganizationalUnitName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAME
*
* Return value:
* The index of the specified revoked certificate upon success
* -1 upon failure
*/
NSS_EXTERN PRIntn
nssPKIXOrganizationalUnitNames_FindOrganizationalUnitName
(
NSSPKIXOrganizationalUnitNames *ous,
NSSPKIXOrganizationalUnitName *ou
);
/*
* nssPKIXOrganizationalUnitNames_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXOrganizationalUnitNames_Equal
(
NSSPKIXOrganizationalUnitNames *ous1,
NSSPKIXOrganizationalUnitNames *ous2,
PRStatus *statusOpt
);
/*
* nssPKIXOrganizationalUnitNames_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXOrganizationalUnitNames upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXOrganizationalUnitNames *
nssPKIXOrganizationalUnitNames_Duplicate
(
NSSPKIXOrganizationalUnitNames *ous,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXOrganizationalUnitNames_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXOrganizationalUnitNames
* 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_ORGANIZATIONAL_UNIT_NAMES
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXOrganizationalUnitNames_verifyPointer
(
NSSPKIXOrganizationalUnitNames *p
);
#endif /* DEBUG */
/*
* OrganizationalUnitName
*
* -- fgmr comments --
*
* From RFC 2459:
*
* OrganizationalUnitName ::= PrintableString (SIZE
* (1..ub-organizational-unit-name-length))
*
* The private calls for this type:
*
* nssPKIXOrganizationalUnitName_Decode
* nssPKIXOrganizationalUnitName_CreateFromUTF8
* nssPKIXOrganizationalUnitName_Encode
*
*/
/*
* nssPKIXOrganizationalUnitName_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 NSSPKIXOrganizationalUnitName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXOrganizationalUnitName *
nssPKIXOrganizationalUnitName_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXOrganizationalUnitName_CreateFromUTF8
*
* { basically just enforces the length limit }
*
* 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 NSSPKIXOrganizationalUnitName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXOrganizationalUnitName *
nssPKIXOrganizationalUnitName_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXOrganizationalUnitName_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAME