CA认证

开发平台：

WINDOWS

pkix.h：源码内容

* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXOrganizationalUnitName_Encode
(
NSSPKIXOrganizationalUnitName *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* BuiltInDomainDefinedAttributes
*
* -- fgmr comments --
*
* From RFC 2459:
*
* BuiltInDomainDefinedAttributes ::= SEQUENCE SIZE
* (1..ub-domain-defined-attributes) OF
* BuiltInDomainDefinedAttribute
*
* The private calls for this type:
*
* nssPKIXBuiltInDomainDefinedAttributes_Decode
* nssPKIXBuiltInDomainDefinedAttributes_Create
* nssPKIXBuiltInDomainDefinedAttributes_Destroy
* nssPKIXBuiltInDomainDefinedAttributes_Encode
* nssPKIXBuiltInDomainDefinedAttributes_GetBuiltIndomainDefinedAttributeCount
* nssPKIXBuiltInDomainDefinedAttributes_GetBuiltIndomainDefinedAttributes
* nssPKIXBuiltInDomainDefinedAttributes_SetBuiltIndomainDefinedAttributes
* nssPKIXBuiltInDomainDefinedAttributes_GetBuiltIndomainDefinedAttribute
* nssPKIXBuiltInDomainDefinedAttributes_SetBuiltIndomainDefinedAttribute
* nssPKIXBuiltInDomainDefinedAttributes_InsertBuiltIndomainDefinedAttribute
* nssPKIXBuiltInDomainDefinedAttributes_AppendBuiltIndomainDefinedAttribute
* nssPKIXBuiltInDomainDefinedAttributes_RemoveBuiltIndomainDefinedAttribute
* nssPKIXBuiltInDomainDefinedAttributes_Equal
* nssPKIXBuiltInDomainDefinedAttributes_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXBuiltInDomainDefinedAttributes_verifyPointer
*
*/
/*
* nssPKIXBuiltInDomainDefinedAttributes_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 NSSPKIXBuiltInDomainDefinedAttributes
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBuiltInDomainDefinedAttributes *
nssPKIXBuiltInDomainDefinedAttributes_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXBuiltInDomainDefinedAttributes_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_DOMAIN_DEFINED_ATTRIBUTE
*
* Return value:
* A valid pointer to an NSSPKIXBuiltInDomainDefinedAttributes
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBuiltInDomainDefinedAttributes *
nssPKIXBuiltInDomainDefinedAttributes_Create
(
NSSArena *arenaOpt,
NSSPKIXBuiltInDomainDefinedAttribute *bidda1,
...
);
/*
* nssPKIXBuiltInDomainDefinedAttributes_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInDomainDefinedAttributes_Destroy
(
NSSPKIXBuiltInDomainDefinedAttributes *biddas
);
/*
* nssPKIXBuiltInDomainDefinedAttributes_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXBuiltInDomainDefinedAttributes_Encode
(
NSSPKIXBuiltInDomainDefinedAttributes *biddas,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInDomainDefinedAttributes_GetBuiltIndomainDefinedAttributeCount
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXBuiltInDomainDefinedAttributes_GetBuiltIndomainDefinedAttributeCount
(
NSSPKIXBuiltInDomainDefinedAttributes *biddas
);
/*
* nssPKIXBuiltInDomainDefinedAttributes_GetBuiltIndomainDefinedAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_ARRAY_TOO_SMALL
*
* Return value:
* A valid pointer to an array of NSSPKIXBuiltInDomainDefinedAttribute
* pointers upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBuiltInDomainDefinedAttribute **
nssPKIXBuiltInDomainDefinedAttributes_GetBuiltIndomainDefinedAttributes
(
NSSPKIXBuiltInDomainDefinedAttributes *biddas,
NSSPKIXBuiltInDomainDefinedAttribut *rvOpt[],
PRInt32 limit,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInDomainDefinedAttributes_SetBuiltIndomainDefinedAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInDomainDefinedAttributes_SetBuiltIndomainDefinedAttributes
(
NSSPKIXBuiltInDomainDefinedAttributes *biddas,
NSSPKIXBuiltInDomainDefinedAttribut *bidda[],
PRInt32 count
);
/*
* nssPKIXBuiltInDomainDefinedAttributes_GetBuiltIndomainDefinedAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXBuiltInDomainDefinedAttribute
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBuiltInDomainDefinedAttribute *
nssPKIXBuiltInDomainDefinedAttributes_GetBuiltIndomainDefinedAttribute
(
NSSPKIXBuiltInDomainDefinedAttributes *biddas,
PRInt32 i,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInDomainDefinedAttributes_SetBuiltIndomainDefinedAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInDomainDefinedAttributes_SetBuiltIndomainDefinedAttribute
(
NSSPKIXBuiltInDomainDefinedAttributes *biddas,
PRInt32 i,
NSSPKIXBuiltInDomainDefinedAttribute *bidda
);
/*
* nssPKIXBuiltInDomainDefinedAttributes_InsertBuiltIndomainDefinedAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInDomainDefinedAttributes_InsertBuiltIndomainDefinedAttribute
(
NSSPKIXBuiltInDomainDefinedAttributes *biddas,
PRInt32 i,
NSSPKIXBuiltInDomainDefinedAttribute *bidda
);
/*
* nssPKIXBuiltInDomainDefinedAttributes_AppendBuiltIndomainDefinedAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInDomainDefinedAttributes_AppendBuiltIndomainDefinedAttribute
(
NSSPKIXBuiltInDomainDefinedAttributes *biddas,
NSSPKIXBuiltInDomainDefinedAttribute *bidda
);
/*
* nssPKIXBuiltInDomainDefinedAttributes_RemoveBuiltIndomainDefinedAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInDomainDefinedAttributes_RemoveBuiltIndomainDefinedAttribute
(
NSSPKIXBuiltInDomainDefinedAttributes *biddas,
PRInt32 i
);
/*
* nssPKIXBuiltInDomainDefinedAttributes_FindBuiltIndomainDefinedAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTE
*
* Return value:
* The index of the specified revoked certificate upon success
* -1 upon failure
*/
NSS_EXTERN PRInt32
nssPKIXBuiltInDomainDefinedAttributes_FindBuiltIndomainDefinedAttribute
(
NSSPKIXBuiltInDomainDefinedAttributes *biddas,
NSSPKIXBuiltInDomainDefinedAttribute *bidda
);
/*
* nssPKIXBuiltInDomainDefinedAttributes_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXBuiltInDomainDefinedAttributes_Equal
(
NSSPKIXBuiltInDomainDefinedAttributes *biddas1,
NSSPKIXBuiltInDomainDefinedAttributes *biddas2,
PRStatus *statusOpt
);
/*
* nssPKIXBuiltInDomainDefinedAttributes_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXBuiltInDomainDefinedAttributes
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBuiltInDomainDefinedAttributes *
nssPKIXBuiltInDomainDefinedAttributes_Duplicate
(
NSSPKIXBuiltInDomainDefinedAttributes *biddas,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXBuiltInDomainDefinedAttributes_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXBuiltInDomainDefinedAttributes
* 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_DOMAIN_DEFINED_ATTRIBUTES
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInDomainDefinedAttributes_verifyPointer
(
NSSPKIXBuiltInDomainDefinedAttributes *p
);
#endif /* DEBUG */
/*
* BuiltInDomainDefinedAttribute
*
* -- fgmr comments --
*
* From RFC 2459:
*
* BuiltInDomainDefinedAttribute ::= SEQUENCE {
* type PrintableString (SIZE
* (1..ub-domain-defined-attribute-type-length)),
* value PrintableString (SIZE
* (1..ub-domain-defined-attribute-value-length))}
*
* The private calls for this type:
*
* nssPKIXBuiltInDomainDefinedAttribute_Decode
* nssPKIXBuiltInDomainDefinedAttribute_Create
* nssPKIXBuiltInDomainDefinedAttribute_Destroy
* nssPKIXBuiltInDomainDefinedAttribute_Encode
* nssPKIXBuiltInDomainDefinedAttribute_GetType
* nssPKIXBuiltInDomainDefinedAttribute_SetType
* nssPKIXBuiltInDomainDefinedAttribute_GetValue
* nssPKIXBuiltInDomainDefinedAttribute_SetValue
* nssPKIXBuiltInDomainDefinedAttribute_Equal
* nssPKIXBuiltInDomainDefinedAttribute_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXBuiltInDomainDefinedAttribute_verifyPointer
*
*/
/*
* nssPKIXBuiltInDomainDefinedAttribute_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 NSSPKIXBuiltInDomainDefinedAttribute
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBuiltInDomainDefinedAttribute *
nssPKIXBuiltInDomainDefinedAttribute_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXBuiltInDomainDefinedAttribute_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 NSSPKIXBuiltInDomainDefinedAttribute
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBuiltInDomainDefinedAttribute *
nssPKIXBuiltInDomainDefinedAttribute_Create
(
NSSArena *arenaOpt,
NSSUTF8 *type,
NSSUTF8 *value
);
/*
* nssPKIXBuiltInDomainDefinedAttribute_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInDomainDefinedAttribute_Destroy
(
NSSPKIXBuiltInDomainDefinedAttribute *bidda
);
/*
* nssPKIXBuiltInDomainDefinedAttribute_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXBuiltInDomainDefinedAttribute_Encode
(
NSSPKIXBuiltInDomainDefinedAttribute *bidda,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInDomainDefinedAttribute_GetType
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSUTF8 pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXBuiltInDomainDefinedAttribute_GetType
(
NSSPKIXBuiltInDomainDefinedAttribute *bidda,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInDomainDefinedAttribute_SetType
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInDomainDefinedAttribute_SetType
(
NSSPKIXBuiltInDomainDefinedAttribute *bidda,
NSSUTF8 *type
);
/*
* nssPKIXBuiltInDomainDefinedAttribute_GetValue
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSUTF8 pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXBuiltInDomainDefinedAttribute_GetValue
(
NSSPKIXBuiltInDomainDefinedAttribute *bidda,
NSSArena *arenaOpt
);
/*
* nssPKIXBuiltInDomainDefinedAttribute_SetValue
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInDomainDefinedAttribute_SetValue
(
NSSPKIXBuiltInDomainDefinedAttribute *bidda,
NSSUTF8 *value
);
/*
* nssPKIXBuiltInDomainDefinedAttribute_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTE
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXBuiltInDomainDefinedAttribute_Equal
(
NSSPKIXBuiltInDomainDefinedAttribute *bidda1,
NSSPKIXBuiltInDomainDefinedAttribute *bidda2,
PRStatus *statusOpt
);
/*
* nssPKIXBuiltInDomainDefinedAttribute_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXBuiltInDomainDefinedAttribute
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXBuiltInDomainDefinedAttribute *
nssPKIXBuiltInDomainDefinedAttribute_Duplicate
(
NSSPKIXBuiltInDomainDefinedAttribute *bidda,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXBuiltInDomainDefinedAttribute_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXBuiltInDomainDefinedAttribute
* 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_DOMAIN_DEFINED_ATTRIBUTE
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXBuiltInDomainDefinedAttribute_verifyPointer
(
NSSPKIXBuiltInDomainDefinedAttribute *p
);
#endif /* DEBUG */
/*
* ExtensionAttributes
*
* -- fgmr comments --
*
* From RFC 2459:
*
* ExtensionAttributes ::= SET SIZE (1..ub-extension-attributes) OF
* ExtensionAttribute
*
* The private calls for this type:
*
* nssPKIXExtensionAttributes_Decode
* nssPKIXExtensionAttributes_Create
* nssPKIXExtensionAttributes_Destroy
* nssPKIXExtensionAttributes_Encode
* nssPKIXExtensionAttributes_GetExtensionAttributeCount
* nssPKIXExtensionAttributes_GetExtensionAttributes
* nssPKIXExtensionAttributes_SetExtensionAttributes
* nssPKIXExtensionAttributes_GetExtensionAttribute
* nssPKIXExtensionAttributes_SetExtensionAttribute
* nssPKIXExtensionAttributes_InsertExtensionAttribute
* nssPKIXExtensionAttributes_AppendExtensionAttribute
* nssPKIXExtensionAttributes_RemoveExtensionAttribute
* nssPKIXExtensionAttributes_FindExtensionAttribute
* nssPKIXExtensionAttributes_Equal
* nssPKIXExtensionAttributes_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXExtensionAttributes_verifyPointer
*
*/
/*
* nssPKIXExtensionAttributes_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 NSSPKIXExtensionAttributes upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtensionAttributes *
nssPKIXExtensionAttributes_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXExtensionAttributes_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTE
*
* Return value:
* A valid pointer to an NSSPKIXExtensionAttributes upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtensionAttributes *
nssPKIXExtensionAttributes_Create
(
NSSArena *arenaOpt,
NSSPKIXExtensionAttribute ea1,
...
);
/*
* nssPKIXExtensionAttributes_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtensionAttributes_Destroy
(
NSSPKIXExtensionAttributes *eas
);
/*
* nssPKIXExtensionAttributes_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXExtensionAttributes_Encode
(
NSSPKIXExtensionAttributes *eas
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXExtensionAttributes_GetExtensionAttributeCount
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXExtensionAttributes_GetExtensionAttributeCount
(
NSSPKIXExtensionAttributes *eas
);
/*
* nssPKIXExtensionAttributes_GetExtensionAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_ARRAY_TOO_SMALL
*
* Return value:
* A valid pointer to an array of NSSPKIXExtensionAttribute pointers
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtensionAttribute **
nssPKIXExtensionAttributes_GetExtensionAttributes
(
NSSPKIXExtensionAttributes *eas,
NSSPKIXExtensionAttribute *rvOpt[],
PRInt32 limit,
NSSArena *arenaOpt
);
/*
* nssPKIXExtensionAttributes_SetExtensionAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTES
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTE
* NSS_ERROR_INVALID_POINTER
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtensionAttributes_SetExtensionAttributes
(
NSSPKIXExtensionAttributes *eas,
NSSPKIXExtensionAttribute *ea[],
PRInt32 count
);
/*
* nssPKIXExtensionAttributes_GetExtensionAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTES
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXExtensionAttribute upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtensionAttribute *
nssPKIXExtensionAttributes_GetExtensionAttribute
(
NSSPKIXExtensionAttributes *eas,
PRInt32 i,
NSSArena *arenaOpt
);
/*
* nssPKIXExtensionAttributes_SetExtensionAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTES
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtensionAttributes_SetExtensionAttribute
(
NSSPKIXExtensionAttributes *eas,
PRInt32 i,
NSSPKIXExtensionAttribute *ea
);
/*
* nssPKIXExtensionAttributes_InsertExtensionAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTES
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtensionAttributes_InsertExtensionAttribute
(
NSSPKIXExtensionAttributes *eas,
PRInt32 i,
NSSPKIXExtensionAttribute *ea
);
/*
* nssPKIXExtensionAttributes_AppendExtensionAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTES
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtensionAttributes_AppendExtensionAttribute
(
NSSPKIXExtensionAttributes *eas,
NSSPKIXExtensionAttribute *ea
);
/*
* nssPKIXExtensionAttributes_RemoveExtensionAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtensionAttributes_RemoveExtensionAttribute
(
NSSPKIXExtensionAttributes *eas,
PRInt32 i,
);
/*
* nssPKIXExtensionAttributes_FindExtensionAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTES
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTE
*
* Return value:
* A nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXExtensionAttributes_FindExtensionAttribute
(
NSSPKIXExtensionAttributes *eas,
NSSPKIXExtensionAttribute *ea
);
/*
* nssPKIXExtensionAttributes_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTES
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXExtensionAttributes_Equal
(
NSSPKIXExtensionAttributes *eas1,
NSSPKIXExtensionAttributes *eas2,
PRStatus *statusOpt
);
/*
* nssPKIXExtensionAttributes_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTES
*
* Return value:
* A valid pointer to an NSSPKIXExtensionAttributes upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtensionAttributes *
nssPKIXExtensionAttributes_Duplicate
(
NSSPKIXExtensionAttributes *eas,
NSSArena *arenaOpt
);
/*
* fgmr
* There should be accessors to search the ExtensionAttributes and
* return the value for a specific value, etc.
*/
#ifdef DEBUG
/*
* nssPKIXExtensionAttributes_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXExtensionAttributes
* 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_EXTENSION_ATTRIBUTES
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXExtensionAttributes_verifyPointer
(
NSSPKIXExtensionAttributes *p
);
#endif /* DEBUG */
/*
* ExtensionAttribute
*
* -- fgmr comments --
*
* From RFC 2459:
*
* ExtensionAttribute ::= SEQUENCE {
* extension-attribute-type [0] INTEGER (0..ub-extension-attributes),
* extension-attribute-value [1]
* ANY DEFINED BY extension-attribute-type }
*
* The private calls for this type:
*
* nssPKIXExtensionAttribute_Decode
* nssPKIXExtensionAttribute_Create
* nssPKIXExtensionAttribute_Destroy
* nssPKIXExtensionAttribute_Encode
* nssPKIXExtensionAttribute_GetExtensionsAttributeType
* nssPKIXExtensionAttribute_SetExtensionsAttributeType
* nssPKIXExtensionAttribute_GetExtensionsAttributeValue
* nssPKIXExtensionAttribute_SetExtensionsAttributeValue
* nssPKIXExtensionAttribute_Equal
* nssPKIXExtensionAttribute_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXExtensionAttribute_verifyPointer
*
*/
/*
* nssPKIXExtensionAttribute_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 NSSPKIXExtensionAttribute upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtensionAttribute *
nssPKIXExtensionAttribute_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXExtensionAttribute_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTE_TYPE
* NSS_ERROR_INVALID_POINTER
*
* Return value:
* A valid pointer to an NSSPKIXExtensionAttribute upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtensionAttribute *
nssPKIXExtensionAttribute_Create
(
NSSArena *arenaOpt,
NSSPKIXExtensionAttributeType type,
NSSItem *value
);
/*
* nssPKIXExtensionAttribute_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtensionAttribute_Destroy
(
NSSPKIXExtensionAttribute *ea
);
/*
* nssPKIXExtensionAttribute_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXExtensionAttribute_Encode
(
NSSPKIXExtensionAttribute *ea,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXExtensionAttribute_GetExtensionsAttributeType
*
* -- fgmr comments --
* {One of these objects created from BER generated by a program
* adhering to a later version of the PKIX standards might have
* a value not mentioned in the enumeration definition. This isn't
* a bug.}
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTE
*
* Return value:
* A member of the NSSPKIXExtensionAttributeType enumeration
* upon success
* NSSPKIXExtensionAttributeType_NSSinvalid upon failure
*/
NSS_EXTERN NSSPKIXExtensionAttributeType
nssPKIXExtensionAttribute_GetExtensionsAttributeType
(
NSSPKIXExtensionAttribute *ea
);
/*
* nssPKIXExtensionAttribute_SetExtensionsAttributeType
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtensionAttribute_SetExtensionsAttributeType
(
NSSPKIXExtensionAttribute *ea,
NSSPKIXExtensionAttributeType type
);
/*
* nssPKIXExtensionAttribute_GetExtensionsAttributeValue
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSItem upon success
* NULL upon failure
*/
NSS_EXTERN NSSItem *
nssPKIXExtensionAttribute_GetExtensionsAttributeValue
(
NSSPKIXExtensionAttribute *ea,
NSSItem *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXExtensionAttribute_SetExtensionsAttributeValue
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtensionAttribute_SetExtensionsAttributeValue
(
NSSPKIXExtensionAttribute *ea,
NSSItem *value
);
/*
* nssPKIXExtensionAttribute_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTE
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXExtensionAttribute_Equal
(
NSSPKIXExtensionAttribute *ea1,
NSSPKIXExtensionAttribute *ea2,
PRStatus *statusOpt
);
/*
* nssPKIXExtensionAttribute_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXExtensionAttribute upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtensionAttribute *
nssPKIXExtensionAttribute_Duplicate
(
NSSPKIXExtensionAttribute *ea,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXExtensionAttribute_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXExtensionAttribute
* 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_EXTENSION_ATTRIBUTE
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXExtensionAttribute_verifyPointer
(
NSSPKIXExtensionAttribute *p
);
#endif /* DEBUG */
/*
* CommonName
*
* -- fgmr comments --
*
* From RFC 2459:
*
* CommonName ::= PrintableString (SIZE (1..ub-common-name-length))
*
* The private calls for this type:
*
* nssPKIXCommonName_Decode
* nssPKIXCommonName_CreateFromUTF8
* nssPKIXCommonName_Encode
*
*/
/*
* nssPKIXCommonName_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 NSSPKIXCommonName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXCommonName *
nssPKIXCommonName_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXCommonName_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 NSSPKIXCommonName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXCommonName *
nssPKIXCommonName_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXCommonName_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_COMMON_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXCommonName_Encode
(
NSSPKIXCommonName *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* TeletexCommonName
*
* -- fgmr comments --
*
* From RFC 2459:
*
* TeletexCommonName ::= TeletexString (SIZE (1..ub-common-name-length))
*
* The private calls for this type:
*
* nssPKIXTeletexCommonName_Decode
* nssPKIXTeletexCommonName_CreateFromUTF8
* nssPKIXTeletexCommonName_Encode
*
*/
/*
* nssPKIXTeletexCommonName_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 NSSPKIXTeletexCommonName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexCommonName *
nssPKIXTeletexCommonName_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXTeletexCommonName_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 NSSPKIXTeletexCommonName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexCommonName *
nssPKIXTeletexCommonName_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXTeletexCommonName_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_COMMON_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXTeletexCommonName_Encode
(
NSSPKIXTeletexCommonName *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* TeletexOrganizationName
*
* -- fgmr comments --
*
* From RFC 2459:
*
* TeletexOrganizationName ::=
* TeletexString (SIZE (1..ub-organization-name-length))
*
* The private calls for this type:
*
* nssPKIXTeletexOrganizationName_Decode
* nssPKIXTeletexOrganizationName_CreateFromUTF8
* nssPKIXTeletexOrganizationName_Encode
*
*/
/*
* nssPKIXTeletexOrganizationName_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 NSSPKIXTeletexOrganizationName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexOrganizationName *
nssPKIXTeletexOrganizationName_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXTeletexOrganizationName_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 NSSPKIXTeletexOrganizationName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexOrganizationName *
nssPKIXTeletexOrganizationName_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXTeletexOrganizationName_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATION_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXTeletexOrganizationName_Encode
(
NSSPKIXTeletexOrganizationName *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* TeletexPersonalName
*
* -- fgmr comments --
*
* From RFC 2459:
*
* TeletexPersonalName ::= SET {
* surname [0] TeletexString (SIZE (1..ub-surname-length)),
* given-name [1] TeletexString
* (SIZE (1..ub-given-name-length)) OPTIONAL,
* initials [2] TeletexString (SIZE (1..ub-initials-length)) OPTIONAL,
* generation-qualifier [3] TeletexString (SIZE
* (1..ub-generation-qualifier-length)) OPTIONAL }
*
* The private calls for this type:
*
* nssPKIXTeletexPersonalName_Decode
* nssPKIXTeletexPersonalName_Create
* nssPKIXTeletexPersonalName_Destroy
* nssPKIXTeletexPersonalName_Encode
* nssPKIXTeletexPersonalName_GetSurname
* nssPKIXTeletexPersonalName_SetSurname
* nssPKIXTeletexPersonalName_HasGivenName
* nssPKIXTeletexPersonalName_GetGivenName
* nssPKIXTeletexPersonalName_SetGivenName
* nssPKIXTeletexPersonalName_RemoveGivenName
* nssPKIXTeletexPersonalName_HasInitials
* nssPKIXTeletexPersonalName_GetInitials
* nssPKIXTeletexPersonalName_SetInitials
* nssPKIXTeletexPersonalName_RemoveInitials
* nssPKIXTeletexPersonalName_HasGenerationQualifier
* nssPKIXTeletexPersonalName_GetGenerationQualifier
* nssPKIXTeletexPersonalName_SetGenerationQualifier
* nssPKIXTeletexPersonalName_RemoveGenerationQualifier
* nssPKIXTeletexPersonalName_Equal
* nssPKIXTeletexPersonalName_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXTeletexPersonalName_verifyPointer
*
*/
/*
* nssPKIXTeletexPersonalName_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 NSSPKIXTeletexPersonalName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexPersonalName *
nssPKIXTeletexPersonalName_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXTeletexPersonalName_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 NSSPKIXTeletexPersonalName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexPersonalName *
nssPKIXTeletexPersonalName_Create
(
NSSArena *arenaOpt,
NSSUTF8 *surname,
NSSUTF8 *givenNameOpt,
NSSUTF8 *initialsOpt,
NSSUTF8 *generationQualifierOpt
);
/*
* nssPKIXTeletexPersonalName_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexPersonalName_Destroy
(
NSSPKIXTeletexPersonalName *personalName
);
/*
* nssPKIXTeletexPersonalName_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXTeletexPersonalName_Encode
(
NSSPKIXTeletexPersonalName *personalName,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXTeletexPersonalName_GetSurname
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_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 *
nssPKIXTeletexPersonalName_GetSurname
(
NSSPKIXTeletexPersonalName *personalName,
NSSArena *arenaOpt
);
/*
* nssPKIXTeletexPersonalName_SetSurname
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
* NSS_ERROR_INVALID_STRING
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexPersonalName_SetSurname
(
NSSPKIXTeletexPersonalName *personalName,
NSSUTF8 *surname
);
/*
* nssPKIXTeletexPersonalName_HasGivenName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXTeletexPersonalName_HasGivenName
(
NSSPKIXTeletexPersonalName *personalName,
PRStatus *statusOpt
);
/*
* nssPKIXTeletexPersonalName_GetGivenName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
*
* Return value:
* A valid pointer to an NSSUTF8 upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXTeletexPersonalName_GetGivenName
(
NSSPKIXTeletexPersonalName *personalName,
NSSArena *arenaOpt
);
/*
* nssPKIXTeletexPersonalName_SetGivenName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
* NSS_ERROR_INVALID_STRING
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexPersonalName_SetGivenName
(
NSSPKIXTeletexPersonalName *personalName,
NSSUTF8 *givenName
);
/*
* nssPKIXTeletexPersonalName_RemoveGivenName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexPersonalName_RemoveGivenName
(
NSSPKIXTeletexPersonalName *personalName
);
/*
* nssPKIXTeletexPersonalName_HasInitials
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXTeletexPersonalName_HasInitials
(
NSSPKIXTeletexPersonalName *personalName,
PRStatus *statusOpt
);
/*
* nssPKIXTeletexPersonalName_GetInitials
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_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 *
nssPKIXTeletexPersonalName_GetInitials
(
NSSPKIXTeletexPersonalName *personalName,
NSSArena *arenaOpt
);
/*
* nssPKIXTeletexPersonalName_SetInitials
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
* NSS_ERROR_INVALID_STRING
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexPersonalName_SetInitials
(
NSSPKIXTeletexPersonalName *personalName,
NSSUTF8 *initials
);
/*
* nssPKIXTeletexPersonalName_RemoveInitials
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexPersonalName_RemoveInitials
(
NSSPKIXTeletexPersonalName *personalName
);
/*
* nssPKIXTeletexPersonalName_HasGenerationQualifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXTeletexPersonalName_HasGenerationQualifier
(
NSSPKIXTeletexPersonalName *personalName,
PRStatus *statusOpt
);
/*
* nssPKIXTeletexPersonalName_GetGenerationQualifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
*
* Return value:
* A valid pointer to an NSSUTF8 upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXTeletexPersonalName_GetGenerationQualifier
(
NSSPKIXTeletexPersonalName *personalName,
NSSArena *arenaOpt
);
/*
* nssPKIXTeletexPersonalName_SetGenerationQualifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
* NSS_ERROR_INVALID_STRING
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexPersonalName_SetGenerationQualifier
(
NSSPKIXTeletexPersonalName *personalName,
NSSUTF8 *generationQualifier
);
/*
* nssPKIXTeletexPersonalName_RemoveGenerationQualifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexPersonalName_RemoveGenerationQualifier
(
NSSPKIXTeletexPersonalName *personalName
);
/*
* nssPKIXTeletexPersonalName_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXTeletexPersonalName_Equal
(
NSSPKIXTeletexPersonalName *personalName1,
NSSPKIXTeletexPersonalName *personalName2,
PRStatus *statusOpt
);
/*
* nssPKIXTeletexPersonalName_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_PERSONAL_NAME
*
* Return value:
* A valid pointer to an NSSPKIXTeletexPersonalName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexPersonalName *
nssPKIXTeletexPersonalName_Duplicate
(
NSSPKIXTeletexPersonalName *personalName,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXTeletexPersonalName_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXTeletexPersonalName
* 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_TELETEX_PERSONAL_NAME
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXTeletexPersonalName_verifyPointer
(
NSSPKIXTeletexPersonalName *p
);
#endif /* DEBUG */
/*
* TeletexOrganizationalUnitNames
*
* -- fgmr comments --
*
* From RFC 2459:
*
* TeletexOrganizationalUnitNames ::= SEQUENCE SIZE
* (1..ub-organizational-units) OF TeletexOrganizationalUnitName
*
* The private calls for the type:
*
* nssPKIXTeletexOrganizationalUnitNames_Decode
* nssPKIXTeletexOrganizationalUnitNames_Create
* nssPKIXTeletexOrganizationalUnitNames_Destroy
* nssPKIXTeletexOrganizationalUnitNames_Encode
* nssPKIXTeletexOrganizationalUnitNames_GetTeletexOrganizationalUnitNameCount
* nssPKIXTeletexOrganizationalUnitNames_GetTeletexOrganizationalUnitNames
* nssPKIXTeletexOrganizationalUnitNames_SetTeletexOrganizationalUnitNames
* nssPKIXTeletexOrganizationalUnitNames_GetTeletexOrganizationalUnitName
* nssPKIXTeletexOrganizationalUnitNames_SetTeletexOrganizationalUnitName
* nssPKIXTeletexOrganizationalUnitNames_InsertTeletexOrganizationalUnitName
* nssPKIXTeletexOrganizationalUnitNames_AppendTeletexOrganizationalUnitName
* nssPKIXTeletexOrganizationalUnitNames_RemoveTeletexOrganizationalUnitName
* nssPKIXTeletexOrganizationalUnitNames_FindTeletexOrganizationalUnitName
* nssPKIXTeletexOrganizationalUnitNames_Equal
* nssPKIXTeletexOrganizationalUnitNames_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXTeletexOrganizationalUnitNames_verifyPointer
*
*/
/*
* nssPKIXTeletexOrganizationalUnitNames_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 NSSPKIXTeletexOrganizationalUnitNames upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexOrganizationalUnitNames *
nssPKIXTeletexOrganizationalUnitNames_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXTeletexOrganizationalUnitNames_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAME
*
* Return value:
* A valid pointer to an NSSPKIXTeletexOrganizationalUnitNames upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexOrganizationalUnitNames *
nssPKIXTeletexOrganizationalUnitNames_Create
(
NSSArena *arenaOpt,
NSSPKIXTeletexOrganizationalUnitName *ou1,
...
);
/*
* nssPKIXTeletexOrganizationalUnitNames_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAMES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexOrganizationalUnitNames_Destroy
(
NSSPKIXTeletexOrganizationalUnitNames *ous
);
/*
* nssPKIXTeletexOrganizationalUnitNames_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_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 *
nssPKIXTeletexOrganizationalUnitNames_Encode
(
NSSPKIXTeletexOrganizationalUnitNames *ous,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXTeletexOrganizationalUnitNames_GetTeletexOrganizationalUnitNameCount
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXTeletexOrganizationalUnitNames_GetTeletexOrganizationalUnitNameCount
(
NSSPKIXTeletexOrganizationalUnitNames *ous
);
/*
* nssPKIXTeletexOrganizationalUnitNames_GetTeletexOrganizationalUnitNames
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_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 NSSPKIXTeletexOrganizationalUnitName
* pointers upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexOrganizationalUnitName **
nssPKIXTeletexOrganizationalUnitNames_GetTeletexOrganizationalUnitNames
(
NSSPKIXTeletexOrganizationalUnitNames *ous,
NSSPKIXTeletexOrganizationalUnitName *rvOpt[],
PRInt32 limit,
NSSArena *arenaOpt
);
/*
* nssPKIXTeletexOrganizationalUnitNames_SetTeletexOrganizationalUnitNames
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexOrganizationalUnitNames_SetTeletexOrganizationalUnitNames
(
NSSPKIXTeletexOrganizationalUnitNames *ous,
NSSPKIXTeletexOrganizationalUnitName *ou[],
PRInt32 count
);
/*
* nssPKIXTeletexOrganizationalUnitNames_GetTeletexOrganizationalUnitName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXTeletexOrganizationalUnitName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexOrganizationalUnitName *
nssPKIXTeletexOrganizationalUnitNames_GetTeletexOrganizationalUnitName
(
NSSPKIXTeletexOrganizationalUnitNames *ous,
PRInt32 i,
NSSArena *arenaOpt
);
/*
* nssPKIXTeletexOrganizationalUnitNames_SetTeletexOrganizationalUnitName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_INVALID_PKIX_TELETEX_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
nssPKIXTeletexOrganizationalUnitNames_SetTeletexOrganizationalUnitName
(
NSSPKIXTeletexOrganizationalUnitNames *ous,
PRInt32 i,
NSSPKIXTeletexOrganizationalUnitName *ou
);
/*
* nssPKIXTeletexOrganizationalUnitNames_InsertTeletexOrganizationalUnitName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_INVALID_PKIX_TELETEX_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
nssPKIXTeletexOrganizationalUnitNames_InsertTeletexOrganizationalUnitName
(
NSSPKIXTeletexOrganizationalUnitNames *ous,
PRInt32 i,
NSSPKIXTeletexOrganizationalUnitName *ou
);
/*
* nssPKIXTeletexOrganizationalUnitNames_AppendTeletexOrganizationalUnitName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexOrganizationalUnitNames_AppendTeletexOrganizationalUnitName
(
NSSPKIXTeletexOrganizationalUnitNames *ous,
NSSPKIXTeletexOrganizationalUnitName *ou
);
/*
* nssPKIXTeletexOrganizationalUnitNames_RemoveTeletexOrganizationalUnitName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexOrganizationalUnitNames_RemoveTeletexOrganizationalUnitName
(
NSSPKIXTeletexOrganizationalUnitNames *ous,
PRInt32 i
);
/*
* nssPKIXTeletexOrganizationalUnitNames_FindTeletexOrganizationalUnitName
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAME
*
* Return value:
* The index of the specified revoked certificate upon success
* -1 upon failure
*/
NSS_EXTERN PRInt32
nssPKIXTeletexOrganizationalUnitNames_FindTeletexOrganizationalUnitName
(
NSSPKIXTeletexOrganizationalUnitNames *ous,
NSSPKIXTeletexOrganizationalUnitName *ou
);
/*
* nssPKIXTeletexOrganizationalUnitNames_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAMES
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXTeletexOrganizationalUnitNames_Equal
(
NSSPKIXTeletexOrganizationalUnitNames *ous1,
NSSPKIXTeletexOrganizationalUnitNames *ous2,
PRStatus *statusOpt
);
/*
* nssPKIXTeletexOrganizationalUnitNames_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAMES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSPKIXTeletexOrganizationalUnitNames upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexOrganizationalUnitNames *
nssPKIXTeletexOrganizationalUnitNames_Duplicate
(
NSSPKIXTeletexOrganizationalUnitNames *ous,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXTeletexOrganizationalUnitNames_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXTeletexOrganizationalUnitNames
* 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_TELETEX_ORGANIZATIONAL_UNIT_NAME
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXTeletexOrganizationalUnitNames_verifyPointer
(
NSSPKIXTeletexOrganizationalUnitNames *p
);
#endif /* DEBUG */
/*
* TeletexOrganizationalUnitName
*
* -- fgmr comments --
*
* From RFC 2459:
*
* TeletexOrganizationalUnitName ::= TeletexString
* (SIZE (1..ub-organizational-unit-name-length))
*
* The private calls for this type:
*
* nssPKIXTeletexOrganizationalUnitName_Decode
* nssPKIXTeletexOrganizationalUnitName_CreateFromUTF8
* nssPKIXTeletexOrganizationalUnitName_Encode
*
*/
/*
* nssPKIXTeletexOrganizationalUnitName_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 NSSPKIXTeletexOrganizationalUnitName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexOrganizationalUnitName *
nssPKIXTeletexOrganizationalUnitName_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXTeletexOrganizationalUnitName_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 NSSPKIXTeletexOrganizationalUnitName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexOrganizationalUnitName *
nssPKIXTeletexOrganizationalUnitName_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXTeletexOrganizationalUnitName_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_ORGANIZATIONAL_UNIT_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXTeletexOrganizationalUnitName_Encode
(
NSSPKIXTeletexOrganizationalUnitName *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* PDSName
*
* -- fgmr comments --
*
* From RFC 2459:
*
* PDSName ::= PrintableString (SIZE (1..ub-pds-name-length))
*
* The private calls for this type:
*
* nssPKIXPDSName_Decode
* nssPKIXPDSName_CreateFromUTF8
* nssPKIXPDSName_Encode
*
*/
/*
* nssPKIXPDSName_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 NSSPKIXPDSName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPDSName *
nssPKIXPDSName_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXPDSName_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 NSSPKIXPDSName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPDSName *
nssPKIXPDSName_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXPDSName_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PDS_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXPDSName_Encode
(
NSSPKIXPDSName *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* PhysicalDeliveryCountryName
*
* -- fgmr comments --
*
* From RFC 2459:
*
* PhysicalDeliveryCountryName ::= 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:
*
* nssPKIXPhysicalDeliveryCountryName_Decode
* nssPKIXPhysicalDeliveryCountryName_CreateFromUTF8
* nssPKIXPhysicalDeliveryCountryName_Encode
*
*/
/*
* nssPKIXPhysicalDeliveryCountryName_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 NSSPKIXPhysicalDeliveryCountryName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPhysicalDeliveryCountryName *
nssPKIXPhysicalDeliveryCountryName_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXPhysicalDeliveryCountryName_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 NSSPKIXPhysicalDeliveryCountryName upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPhysicalDeliveryCountryName *
nssPKIXPhysicalDeliveryCountryName_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXPhysicalDeliveryCountryName_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PHYSICAL_DELIVERY_COUNTRY_NAME
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXPhysicalDeliveryCountryName_Encode
(
NSSPKIXPhysicalDeliveryCountryName *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* PostalCode
*
* -- fgmr comments --
*
* From RFC 2459:
*
* PostalCode ::= CHOICE {
* numeric-code NumericString (SIZE (1..ub-postal-code-length)),
* printable-code PrintableString (SIZE (1..ub-postal-code-length)) }
*
* The private calls for this type:
*
* nssPKIXPostalCode_Decode
* nssPKIXPostalCode_CreateFromUTF8
* nssPKIXPostalCode_Encode
*
*/
/*
* nssPKIXPostalCode_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 NSSPKIXPostalCode upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPostalCode *
nssPKIXPostalCode_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXPostalCode_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 NSSPKIXPostalCode upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPostalCode *
nssPKIXPostalCode_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXPostalCode_Encode
*
*
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_POSTAL_CODE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXPostalCode_Encode
(
NSSPKIXPostalCode *name,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* PDSParameter
*
* -- fgmr comments --
*
* From RFC 2459:
*
* PDSParameter ::= SET {
* printable-string PrintableString
* (SIZE(1..ub-pds-parameter-length)) OPTIONAL,
* teletex-string TeletexString
* (SIZE(1..ub-pds-parameter-length)) OPTIONAL }
*
* The private calls for this type:
*
* nssPKIXPDSParameter_Decode
* nssPKIXPDSParameter_CreateFromUTF8
* nssPKIXPDSParameter_Create
* nssPKIXPDSParameter_Delete
* nssPKIXPDSParameter_Encode
* nssPKIXPDSParameter_GetUTF8Encoding
* nssPKIXPDSParameter_HasPrintableString
* nssPKIXPDSParameter_GetPrintableString
* nssPKIXPDSParameter_SetPrintableString
* nssPKIXPDSParameter_RemovePrintableString
* nssPKIXPDSParameter_HasTeletexString
* nssPKIXPDSParameter_GetTeletexString
* nssPKIXPDSParameter_SetTeletexString
* nssPKIXPDSParameter_RemoveTeletexString
* nssPKIXPDSParameter_Equal
* nssPKIXPDSParameter_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXPDSParameter_verifyPointer
*/
/*
* nssPKIXPDSParameter_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 NSSPKIXPDSParameter upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPDSParameter *
nssPKIXPDSParameter_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXPDSParameter_CreateFromUTF8
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_STRING
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXPDSParameter upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPDSParameter *
nssPKIXPDSParameter_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXPDSParameter_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 NSSPKIXPDSParameter upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPDSParameter *
nssPKIXPDSParameter_Create
(
NSSArena *arenaOpt,
NSSUTF8 *printableStringOpt,
NSSUTF8 *teletexStringOpt
);
/*
* nssPKIXPDSParameter_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PDS_PARAMETER
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPDSParameter_Destroy
(
NSSPKIXPDSParameter *p
);
/*
* nssPKIXPDSParameter_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PDS_PARAMETER
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXPDSParameter_Encode
(
NSSPKIXPDSParameter *p,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXPDSParameter_GetUTF8Encoding
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PDS_PARAMETER
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSSUTF8 pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXPDSParameter_GetUTF8Encoding
(
NSSPKIXPDSParameter *p,
NSSArena *arenaOpt
);
/*
* nssPKIXPDSParameter_HasPrintableString
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PDS_PARAMETER
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXPDSParameter_HasPrintableString
(
NSSPKIXPDSParameter *p,
PRStatus *statusOpt
);
/*
* nssPKIXPDSParameter_GetPrintableString
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PDS_PARAMETER
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSUTF8 upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXPDSParameter_GetPrintableString
(
NSSPKIXPDSParameter *p,
NSSArena *arenaOpt
);
/*
* nssPKIXPDSParameter_SetPrintableString
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PDS_PARAMETER
* NSS_ERROR_INVALID_STRING
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPDSParameter_SetPrintableString
(
NSSPKIXPDSParameter *p,
NSSUTF8 *printableString
);
/*
* nssPKIXPDSParameter_RemovePrintableString
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PDS_PARAMETER
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPDSParameter_RemovePrintableString
(
NSSPKIXPDSParameter *p
);
/*
* nssPKIXPDSParameter_HasTeletexString
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PDS_PARAMETER
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXPDSParameter_HasTeletexString
(
NSSPKIXPDSParameter *p,
PRStatus *statusOpt
);
/*
* nssPKIXPDSParameter_GetTeletexString
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PDS_PARAMETER
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSUTF8 upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXPDSParameter_GetTeletexString
(
NSSPKIXPDSParameter *p,
NSSArena *arenaOpt
);
/*
* nssPKIXPDSParameter_SetTeletexString
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PDS_PARAMETER
* NSS_ERROR_INVALID_STRING
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPDSParameter_SetTeletexString
(
NSSPKIXPDSParameter *p,
NSSUTF8 *teletexString
);
/*
* nssPKIXPDSParameter_RemoveTeletexString
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PDS_PARAMETER
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXPDSParameter_RemoveTeletexString
(
NSSPKIXPDSParameter *p
);
/*
* nssPKIXPDSParameter_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PDS_PARAMETER
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXPDSParameter_Equal
(
NSSPKIXPDSParameter *p1,
NSSPKIXPDSParameter *p2,
PRStatus *statusOpt
);
/*
* nssPKIXPDSParameter_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_PDS_PARAMETER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXPDSParameter upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPDSParameter *
nssPKIXPDSParameter_Duplicate
(
NSSPKIXPDSParameter *p,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXPDSParameter_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXPDSParameter
* 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_PDS_PARAMETER
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXPDSParameter_verifyPointer
(
NSSPKIXPDSParameter *p
);
#endif /* DEBUG */
/*
* fgmr: what about these PDS types?
*
* PhysicalDeliveryOfficeName
*
* PhysicalDeliveryOfficeNumber
*
* ExtensionORAddressComponents
*
* PhysicalDeliveryPersonalName
*
* PhysicalDeliveryOrganizationName
*
* ExtensionPhysicalDeliveryAddressComponents
*
* StreetAddress
*
* PostOfficeBoxAddress
*
* PosteRestanteAddress
*
* UniquePostalName
*
* LocalPostalAttributes
*
*/
/*
* UnformattedPostalAddress
*
* -- fgmr comments --
*
* From RFC 2459:
*
* UnformattedPostalAddress ::= SET {
* printable-address SEQUENCE SIZE (1..ub-pds-physical-address-lines) OF
* PrintableString (SIZE (1..ub-pds-parameter-length)) OPTIONAL,
* teletex-string TeletexString
* (SIZE (1..ub-unformatted-address-length)) OPTIONAL }
*
* The private calls for the type:
*
*
*/
/*
* ExtendedNetworkAddress
*
* -- fgmr comments --
*
* From RFC 2459:
*
* ExtendedNetworkAddress ::= CHOICE {
* e163-4-address SEQUENCE {
* number [0] NumericString (SIZE (1..ub-e163-4-number-length)),
* sub-address [1] NumericString
* (SIZE (1..ub-e163-4-sub-address-length)) OPTIONAL },
* psap-address [0] PresentationAddress }
*
* The private calls for the type:
*
* nssPKIXExtendedNetworkAddress_Decode
* nssPKIXExtendedNetworkAddress_Create
* nssPKIXExtendedNetworkAddress_Encode
* nssPKIXExtendedNetworkAddress_Destroy
* nssPKIXExtendedNetworkAddress_GetChoice
* nssPKIXExtendedNetworkAddress_Get
* nssPKIXExtendedNetworkAddress_GetE1634Address
* nssPKIXExtendedNetworkAddress_GetPsapAddress
* nssPKIXExtendedNetworkAddress_Set
* nssPKIXExtendedNetworkAddress_SetE163Address
* nssPKIXExtendedNetworkAddress_SetPsapAddress
* nssPKIXExtendedNetworkAddress_Equal
* nssPKIXExtendedNetworkAddress_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXExtendedNetworkAddress_verifyPointer
*
*/
/*
* nssPKIXExtendedNetworkAddress_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 NSSPKIXExtendedNetworkAddress upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtendedNetworkAddress *
nssPKIXExtendedNetworkAddress_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXExtendedNetworkAddress_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_E163_4_ADDRESS
* NSS_ERROR_INVALID_PKIX_PRESENTATION_ADDRESS
*
* Return value:
* A valid pointer to an NSSPKIXExtendedNetworkAddress upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtendedNetworkAddress *
nssPKIXExtendedNetworkAddress_Create
(
NSSArena *arenaOpt,
NSSPKIXExtendedNetworkAddressChoice choice,
void *address
);
/*
* nssPKIXExtendedNetworkAddress_CreateFromE1634Address
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_E163_4_ADDRESS
*
* Return value:
* A valid pointer to an NSSPKIXExtendedNetworkAddress upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtendedNetworkAddress *
nssPKIXExtendedNetworkAddress_CreateFromE1634Address
(
NSSArena *arenaOpt,
NSSPKIXe1634Address *e1634address
);
/*
* nssPKIXExtendedNetworkAddress_CreateFromPresentationAddress
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_PRESENTATION_ADDRESS
*
* Return value:
* A valid pointer to an NSSPKIXExtendedNetworkAddress upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtendedNetworkAddress *
nssPKIXExtendedNetworkAddress_CreateFromPresentationAddress
(
NSSArena *arenaOpt,
NSSPKIXPresentationAddress *presentationAddress
);
/*
* nssPKIXExtendedNetworkAddress_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENDED_NETWORK_ADDRESS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtendedNetworkAddress_Destroy
(
NSSPKIXExtendedNetworkAddress *ena
);
/*
* nssPKIXExtendedNetworkAddress_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENDED_NETWORK_ADDRESS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXExtendedNetworkAddress_Encode
(
NSSPKIXExtendedNetworkAddress *ena,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXExtendedNetworkAddress_GetChoice
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENDED_NETWORK_ADDRESS
*
* Return value:
* A valid element of the NSSPKIXExtendedNetworkAddressChoice upon
* success
* The value nssPKIXExtendedNetworkAddress_NSSinvalid upon failure
*/
NSS_EXTERN NSSPKIXExtendedNetworkAddressChoice
nssPKIXExtendedNetworkAddress_GetChoice
(
NSSPKIXExtendedNetworkAddress *ena
);
/*
* nssPKIXExtendedNetworkAddress_GetSpecifiedChoice
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENDED_NETWORK_ADDRESS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_WRONG_CHOICE
*
* Return value:
* A pointer...
* NULL upon failure
*/
NSS_EXTERN void *
nssPKIXExtendedNetworkAddress_GetSpecifiedChoice
(
NSSPKIXExtendedNetworkAddress *ena,
NSSPKIXExtendedNetworkAddressChoice which,
NSSArena *arenaOpt
);
/*
* nssPKIXExtendedNetworkAddress_GetE1634Address
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENDED_NETWORK_ADDRESS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_WRONG_CHOICE
*
* Return value:
* A valid pointer to an NSSPKIXe1643Address upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXe1643Address *
nssPKIXExtendedNetworkAddress_GetE1634Address
(
NSSPKIXExtendedNetworkAddress *ena,
NSSArena *arenaOpt
);
/*
* nssPKIXExtendedNetworkAddress_GetPresentationAddress
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENDED_NETWORK_ADDRESS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_WRONG_CHOICE
*
* Return value:
* A valid pointer to an NSSPKIXPresentationAddress upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXPresentationAddress *
nssPKIXExtendedNetworkAddress_GetPresentationAddress
(
NSSPKIXExtendedNetworkAddress *ena,
NSSArena *arenaOpt
);
/*
* nssPKIXExtendedNetworkAddress_SetSpecifiedChoice
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENDED_NETWORK_ADDRESS
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_E163_4_ADDRESS
* NSS_ERROR_INVALID_PKIX_PRESENTATION_ADDRESS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtendedNetworkAddress_SetSpecifiedChoice
(
NSSPKIXExtendedNetworkAddress *ena,
NSSPKIXExtendedNetworkAddressChoice which,
void *address
);
/*
* nssPKIXExtendedNetworkAddress_SetE163Address
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENDED_NETWORK_ADDRESS
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_E163_4_ADDRESS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtendedNetworkAddress_SetE163Address
(
NSSPKIXExtendedNetworkAddress *ena,
NSSPKIXe1634Address *e1634address
);
/*
* nssPKIXExtendedNetworkAddress_SetPresentationAddress
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENDED_NETWORK_ADDRESS
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_PRESENTATION_ADDRESS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXExtendedNetworkAddress_SetPresentationAddress
(
NSSPKIXExtendedNetworkAddress *ena,
NSSPKIXPresentationAddress *presentationAddress
);
/*
* nssPKIXExtendedNetworkAddress_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENDED_NETWORK_ADDRESS
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXExtendedNetworkAddress_Equal
(
NSSPKIXExtendedNetworkAddress *ena1,
NSSPKIXExtendedNetworkAddress *ena2,
PRStatus *statusOpt
);
/*
* nssPKIXExtendedNetworkAddress_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_EXTENDED_NETWORK_ADDRESS
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXExtendedNetworkAddress upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXExtendedNetworkAddress *
nssPKIXExtendedNetworkAddress_Duplicate
(
NSSPKIXExtendedNetworkAddress *ena,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXExtendedNetworkAddress_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXExtendedNetworkAddress
* 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_EXTENDED_NETWORK_ADDRESS
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXExtendedNetworkAddress_verifyPointer
(
NSSPKIXExtendedNetworkAddress *p
);
#endif /* DEBUG */
/*
* e163-4-address
*
* Helper structure for ExtendedNetworkAddress.
* -- fgmr comments --
*
* From RFC 2459:
*
* e163-4-address SEQUENCE {
* number [0] NumericString (SIZE (1..ub-e163-4-number-length)),
* sub-address [1] NumericString
* (SIZE (1..ub-e163-4-sub-address-length)) OPTIONAL },
*
* The private calls for the type:
*
* nssPKIXe1634Address_Decode
* nssPKIXe1634Address_Create
* nssPKIXe1634Address_Destroy
* nssPKIXe1634Address_Encode
* nssPKIXe1634Address_GetNumber
* nssPKIXe1634Address_SetNumber
* nssPKIXe1634Address_HasSubAddress
* nssPKIXe1634Address_GetSubAddress
* nssPKIXe1634Address_SetSubAddress
* nssPKIXe1634Address_RemoveSubAddress
* nssPKIXe1634Address_Equal
* nssPKIXe1634Address_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXe1634Address_verifyPointer
*
*/
/*
* nssPKIXe1634Address_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 NSSPKIXe1634Address upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXe1634Address *
nssPKIXe1634Address_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXe1634Address_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 NSSPKIXe1634Address upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXe1634Address *
nssPKIXe1634Address_Create
(
NSSArena *arenaOpt,
NSSUTF8 *number,
NSSUTF8 *subAddressOpt
);
/*
* nssPKIXe1634Address_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_E163_4_ADDRESS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXe1634Address_Destroy
(
NSSPKIXe1634Address *e
);
/*
* nssPKIXe1634Address_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_E163_4_ADDRESS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXe1634Address_Encode
(
NSSPKIXe1634Address *e,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXe1634Address_GetNumber
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_E163_4_ADDRESS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSUTF8 upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXe1634Address_GetNumber
(
NSSPKIXe1634Address *e,
NSSArena *arenaOpt
);
/*
* nssPKIXe1634Address_SetNumber
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_E163_4_ADDRESS
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_STRING
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXe1634Address_SetNumber
(
NSSPKIXe1634Address *e,
NSSUTF8 *number
);
/*
* nssPKIXe1634Address_HasSubAddress
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_E163_4_ADDRESS
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXe1634Address_HasSubAddress
(
NSSPKIXe1634Address *e,
PRStatus *statusOpt
);
/*
* nssPKIXe1634Address_GetSubAddress
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_E163_4_ADDRESS
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid pointer to an NSSUTF8 upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXe1634Address_GetSubAddress
(
NSSPKIXe1634Address *e,
NSSArena *arenaOpt
);
/*
* nssPKIXe1634Address_SetSubAddress
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_E163_4_ADDRESS
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_STRING
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXe1634Address_SetSubAddress
(
NSSPKIXe1634Address *e,
NSSUTF8 *subAddress
);
/*
* nssPKIXe1634Address_RemoveSubAddress
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_E163_4_ADDRESS
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXe1634Address_RemoveSubAddress
(
NSSPKIXe1634Address *e
);
/*
* nssPKIXe1634Address_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_E163_4_ADDRESS
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXe1634Address_Equal
(
NSSPKIXe1634Address *e1,
NSSPKIXe1634Address *e2,
PRStatus *statusOpt
);
/*
* nssPKIXe1634Address_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_E163_4_ADDRESS
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXe1634Address upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXe1634Address *
nssPKIXe1634Address_Duplicate
(
NSSPKIXe1634Address *e,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXe1634Address_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXe1634Address
* 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_E163_4_ADDRESS
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXe1634Address_verifyPointer
(
NSSPKIXe1634Address *p
);
#endif /* DEBUG */
/*
* PresentationAddress
*
* -- fgmr comments --
*
* From RFC 2459:
*
* PresentationAddress ::= SEQUENCE {
* pSelector [0] EXPLICIT OCTET STRING OPTIONAL,
* sSelector [1] EXPLICIT OCTET STRING OPTIONAL,
* tSelector [2] EXPLICIT OCTET STRING OPTIONAL,
* nAddresses [3] EXPLICIT SET SIZE (1..MAX) OF OCTET STRING }
*
* The private calls for the type:
*
* nssPKIXPresentationAddress_Decode
* nssPKIXPresentationAddress_Create
* nssPKIXPresentationAddress_Destroy
* nssPKIXPresentationAddress_Encode
* nssPKIXPresentationAddress_HasPSelector
* nssPKIXPresentationAddress_GetPSelector
* nssPKIXPresentationAddress_SetPSelector
* nssPKIXPresentationAddress_RemovePSelector
* nssPKIXPresentationAddress_HasSSelector
* nssPKIXPresentationAddress_GetSSelector
* nssPKIXPresentationAddress_SetSSelector
* nssPKIXPresentationAddress_RemoveSSelector
* nssPKIXPresentationAddress_HasTSelector
* nssPKIXPresentationAddress_GetTSelector
* nssPKIXPresentationAddress_SetTSelector
* nssPKIXPresentationAddress_RemoveTSelector
* nssPKIXPresentationAddress_HasNAddresses
* nssPKIXPresentationAddress_GetNAddresses
* nssPKIXPresentationAddress_SetNAddresses
* nssPKIXPresentationAddress_RemoveNAddresses
*{NAddresses must be more complex than that}
* nssPKIXPresentationAddress_Compare
* nssPKIXPresentationAddress_Duplicate
*
* In debug builds, the following call is available:
*
* _verifyPointer
*
*/
/*
* TeletexDomainDefinedAttributes
*
* -- fgmr comments --
*
* From RFC 2459:
*
* TeletexDomainDefinedAttributes ::= SEQUENCE SIZE
* (1..ub-domain-defined-attributes) OF TeletexDomainDefinedAttribute
*
* The private calls for the type:
*
* nssPKIXTeletexDomainDefinedAttributes_Decode
* nssPKIXTeletexDomainDefinedAttributes_Create
* nssPKIXTeletexDomainDefinedAttributes_Destroy
* nssPKIXTeletexDomainDefinedAttributes_Encode
* nssPKIXTeletexDomainDefinedAttributes_GetTeletexDomainDefinedAttributeCount
* nssPKIXTeletexDomainDefinedAttributes_GetTeletexDomainDefinedAttributes
* nssPKIXTeletexDomainDefinedAttributes_SetTeletexDomainDefinedAttributes
* nssPKIXTeletexDomainDefinedAttributes_GetTeletexDomainDefinedAttribute
* nssPKIXTeletexDomainDefinedAttributes_SetTeletexDomainDefinedAttribute
* nssPKIXTeletexDomainDefinedAttributes_InsertTeletexDomainDefinedAttribute
* nssPKIXTeletexDomainDefinedAttributes_AppendTeletexDomainDefinedAttribute
* nssPKIXTeletexDomainDefinedAttributes_RemoveTeletexDomainDefinedAttribute
* nssPKIXTeletexDomainDefinedAttributes_FindTeletexDomainDefinedAttribute
* nssPKIXTeletexDomainDefinedAttributes_Equal
* nssPKIXTeletexDomainDefinedAttributes_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXTeletexDomainDefinedAttributes_verifyPointer
*
*/
/*
* nssPKIXTeletexDomainDefinedAttributes_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 NSSPKIXTeletexDomainDefinedAttributes
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexDomainDefinedAttributes *
nssPKIXTeletexDomainDefinedAttributes_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXTeletexDomainDefinedAttributes_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_PKIX_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
*
* Return value:
* A valid pointer to an NSSPKIXTeletexDomainDefinedAttributes
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexDomainDefinedAttributes *
nssPKIXTeletexDomainDefinedAttributes_Create
(
NSSArena *arenaOpt,
NSSPKIXTeletexDomainDefinedAttribute *tdda1,
...
);
/*
* nssPKIXTeletexDomainDefinedAttributes_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTES
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexDomainDefinedAttributes_Destroy
(
NSSPKIXTeletexDomainDefinedAttributes *tddas
);
/*
* nssPKIXTeletexDomainDefinedAttributes_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXTeletexDomainDefinedAttributes_Encode
(
NSSPKIXTeletexDomainDefinedAttributes *tddas,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXTeletexDomainDefinedAttributes_GetTeletexDomainDefinedAttributeCount
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* Nonnegative integer upon success
* -1 upon failure.
*/
NSS_EXTERN PRInt32
nssPKIXTeletexDomainDefinedAttributes_GetTeletexDomainDefinedAttributeCount
(
NSSPKIXTeletexDomainDefinedAttributes *tddas
);
/*
* nssPKIXTeletexDomainDefinedAttributes_GetTeletexDomainDefinedAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_ARRAY_TOO_SMALL
*
* Return value:
* A valid pointer to an array of NSSPKIXTeletexDomainDefinedAttribute
* pointers upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexDomainDefinedAttribute **
nssPKIXTeletexDomainDefinedAttributes_GetTeletexDomainDefinedAttributes
(
NSSPKIXTeletexDomainDefinedAttributes *tddas,
NSSPKIXTeletexDomainDefinedAttribute *rvOpt[],
PRInt32 limit,
NSSArena *arenaOpt
);
/*
* nssPKIXTeletexDomainDefinedAttributes_SetTeletexDomainDefinedAttributes
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexDomainDefinedAttributes_SetTeletexDomainDefinedAttributes
(
NSSPKIXTeletexDomainDefinedAttributes *tddas,
NSSPKIXTeletexDomainDefinedAttribute *tdda[],
PRInt32 count
);
/*
* nssPKIXTeletexDomainDefinedAttributes_GetTeletexDomainDefinedAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXTeletexDomainDefinedAttribute upon
* success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexDomainDefinedAttribute *
nssPKIXTeletexDomainDefinedAttributes_GetTeletexDomainDefinedAttribute
(
NSSPKIXTeletexDomainDefinedAttributes *tddas,
PRInt32 i,
NSSArena *arenaOpt
);
/*
* nssPKIXTeletexDomainDefinedAttributes_SetTeletexDomainDefinedAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexDomainDefinedAttributes_SetTeletexDomainDefinedAttribute
(
NSSPKIXTeletexDomainDefinedAttributes *tddas,
PRInt32 i,
NSSPKIXTeletexDomainDefinedAttribute *tdda
);
/*
* nssPKIXTeletexDomainDefinedAttributes_InsertTeletexDomainDefinedAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_VALUE_OUT_OF_RANGE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexDomainDefinedAttributes_InsertTeletexDomainDefinedAttribute
(
NSSPKIXTeletexDomainDefinedAttributes *tddas,
PRInt32 i,
NSSPKIXTeletexDomainDefinedAttribute *tdda
);
/*
* nssPKIXTeletexDomainDefinedAttributes_AppendTeletexDomainDefinedAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_NO_MEMORY
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexDomainDefinedAttributes_AppendTeletexDomainDefinedAttribute
(
NSSPKIXTeletexDomainDefinedAttributes *tddas,
NSSPKIXTeletexDomainDefinedAttribute *tdda
);
/*
* nssPKIXTeletexDomainDefinedAttributes_RemoveTeletexDomainDefinedAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_VALUE_OUT_OF_RANGE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexDomainDefinedAttributes_RemoveTeletexDomainDefinedAttribute
(
NSSPKIXTeletexDomainDefinedAttributes *tddas,
PRInt32 i
);
/*
* nssPKIXTeletexDomainDefinedAttributes_FindTeletexDomainDefinedAttribute
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
*
* Return value:
* The nonnegative integer upon success
* -1 upon failure
*/
NSS_EXTERN PRInt32
nssPKIXTeletexDomainDefinedAttributes_FindTeletexDomainDefinedAttribute
(
NSSPKIXTeletexDomainDefinedAttributes *tddas,
NSSPKIXTeletexDomainDefinedAttribute *tdda
);
/*
* nssPKIXTeletexDomainDefinedAttributes_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTES
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXTeletexDomainDefinedAttributes_Equal
(
NSSPKIXTeletexDomainDefinedAttributes *tddas1,
NSSPKIXTeletexDomainDefinedAttributes *tddas2,
PRStatus *statusOpt
);
/*
* nssPKIXTeletexDomainDefinedAttributes_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_TELETEX_DOMAIN_DEFINED_ATTRIBUTES
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXTeletexDomainDefinedAttributes
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexDomainDefinedAttributes *
nssPKIXTeletexDomainDefinedAttributes_Duplicate
(
NSSPKIXTeletexDomainDefinedAttributes *tddas,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXTeletexDomainDefinedAttributes_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXTeletexDomainDefinedAttributes
* 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_TELETEX_DOMAIN_DEFINED_ATTRIBUTES
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXTeletexDomainDefinedAttributes_verifyPointer
(
NSSPKIXTeletexDomainDefinedAttributes *p
);
#endif /* DEBUG */
/*
* TeletexDomainDefinedAttribute
*
* -- fgmr comments --
*
* From RFC 2459:
*
* TeletexDomainDefinedAttribute ::= SEQUENCE {
* type TeletexString
* (SIZE (1..ub-domain-defined-attribute-type-length)),
* value TeletexString
* (SIZE (1..ub-domain-defined-attribute-value-length)) }
*
* The private calls for the type:
*
* nssPKIXTeletexDomainDefinedAttribute_Decode
* nssPKIXTeletexDomainDefinedAttribute_CreateFromUTF8
* nssPKIXTeletexDomainDefinedAttribute_Create
* nssPKIXTeletexDomainDefinedAttribute_Destroy
* nssPKIXTeletexDomainDefinedAttribute_Encode
* nssPKIXTeletexDomainDefinedAttribute_GetUTF8Encoding
* nssPKIXTeletexDomainDefinedAttribute_GetType
* nssPKIXTeletexDomainDefinedAttribute_SetType
* nssPKIXTeletexDomainDefinedAttribute_GetValue
* nssPKIXTeletexDomainDefinedAttribute_GetValue
* nssPKIXTeletexDomainDefinedAttribute_Equal
* nssPKIXTeletexDomainDefinedAttribute_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXTeletexDomainDefinedAttribute_verifyPointer
*
*/
/*
* nssPKIXTeletexDomainDefinedAttribute_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 NSSPKIXTeletexDomainDefinedAttribute
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexDomainDefinedAttribute *
nssPKIXTeletexDomainDefinedAttribute_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXTeletexDomainDefinedAttribute_CreateFromUTF8
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_STRING
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXTeletexDomainDefinedAttribute
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexDomainDefinedAttribute *
nssPKIXTeletexDomainDefinedAttribute_CreateFromUTF8
(
NSSArena *arenaOpt,
NSSUTF8 *utf8
);
/*
* nssPKIXTeletexDomainDefinedAttribute_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 NSSPKIXTeletexDomainDefinedAttribute
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexDomainDefinedAttribute *
nssPKIXTeletexDomainDefinedAttribute_Create
(
NSSArena *arenaOpt,
NSSUTF8 *type,
NSSUTF8 *value
);
/*
* nssPKIXTeletexDomainDefinedAttribute_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexDomainDefinedAttribute_Destroy
(
NSSPKIXTeletexDomainDefinedAttribute *tdda
);
/*
* nssPKIXTeletexDomainDefinedAttribute_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXTeletexDomainDefinedAttribute_Encode
(
NSSPKIXTeletexDomainDefinedAttribute *tdda,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXTeletexDomainDefinedAttribute_GetUTF8Encoding
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSSUTF8 pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXTeletexDomainDefinedAttribute_GetUTF8Encoding
(
NSSPKIXTeletexDomainDefinedAttribute *tdda,
NSSArena *arenaOpt
);
/*
* nssPKIXTeletexDomainDefinedAttribute_GetType
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSSUTF8 pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXTeletexDomainDefinedAttribute_GetType
(
NSSPKIXTeletexDomainDefinedAttribute *tdda,
NSSArena *arenaOpt
);
/*
* nssPKIXTeletexDomainDefinedAttribute_SetType
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_STRING
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexDomainDefinedAttribute_SetType
(
NSSPKIXTeletexDomainDefinedAttribute *tdda,
NSSUTF8 *type
);
/*
* nssPKIXTeletexDomainDefinedAttribute_GetValue
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSSUTF8 pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSUTF8 *
nssPKIXTeletexDomainDefinedAttribute_GetValue
(
NSSPKIXTeletexDomainDefinedAttribute *tdda,
NSSArena *arenaOpt
);
/*
* nssPKIXTeletexDomainDefinedAttribute_SetValue
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_STRING
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXTeletexDomainDefinedAttribute_SetValue
(
NSSPKIXTeletexDomainDefinedAttribute *tdda,
NSSUTF8 *value
);
/*
* nssPKIXTeletexDomainDefinedAttribute_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXTeletexDomainDefinedAttribute_Equal
(
NSSPKIXTeletexDomainDefinedAttribute *tdda1,
NSSPKIXTeletexDomainDefinedAttribute *tdda2,
PRStatus *statusOpt
);
/*
* nssPKIXTeletexDomainDefinedAttribute_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXTeletexDomainDefinedAttribute
* upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXTeletexDomainDefinedAttribute *
nssPKIXTeletexDomainDefinedAttribute_Duplicate
(
NSSPKIXTeletexDomainDefinedAttribute *tdda,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXTeletexDomainDefinedAttribute_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXTeletexDomainDefinedAttribute
* 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_TELETEX_DOMAIN_DEFINED_ATTRIBUTE
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXTeletexDomainDefinedAttribute_verifyPointer
(
NSSPKIXTeletexDomainDefinedAttribute *p
);
#endif /* DEBUG */
/*
* AuthorityKeyIdentifier
*
* -- fgmr comments --
*
* From RFC 2459:
*
* AuthorityKeyIdentifier ::= SEQUENCE {
* keyIdentifier [0] KeyIdentifier OPTIONAL,
* authorityCertIssuer [1] GeneralNames OPTIONAL,
* authorityCertSerialNumber [2] CertificateSerialNumber OPTIONAL }
* -- authorityCertIssuer and authorityCertSerialNumber shall both
* -- be present or both be absent
*
* The private calls for the type:
*
* nssPKIXAuthorityKeyIdentifier_Decode
* nssPKIXAuthorityKeyIdentifier_Create
* nssPKIXAuthorityKeyIdentifier_Destroy
* nssPKIXAuthorityKeyIdentifier_Encode
* nssPKIXAuthorityKeyIdentifier_HasKeyIdentifier
* nssPKIXAuthorityKeyIdentifier_GetKeyIdentifier
* nssPKIXAuthorityKeyIdentifier_SetKeyIdentifier
* nssPKIXAuthorityKeyIdentifier_RemoveKeyIdentifier
* nssPKIXAuthorityKeyIdentifier_HasAuthorityCertIssuerAndSerialNumber
* nssPKIXAuthorityKeyIdentifier_RemoveAuthorityCertIssuerAndSerialNumber
* nssPKIXAuthorityKeyIdentifier_GetAuthorityCertIssuer
* nssPKIXAuthorityKeyIdentifier_GetAuthorityCertSerialNumber
* nssPKIXAuthorityKeyIdentifier_SetAuthorityCertIssuerAndSerialNumber
* nssPKIXAuthorityKeyIdentifier_Equal
* nssPKIXAuthorityKeyIdentifier_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXAuthorityKeyIdentifier_verifyPointer
*
*/
/*
* nssPKIXAuthorityKeyIdentifier_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 NSSPKIXAuthorityKeyIdentifier upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAuthorityKeyIdentifier *
nssPKIXAuthorityKeyIdentifier_Decode
(
NSSArena *arenaOpt,
NSSBER *ber
);
/*
* nssPKIXAuthorityKeyIdentifier_Create
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_INVALID_ITEM
* NSS_ERROR_INVALID_PKIX_GENERAL_NAMES
* NSS_ERROR_INVALID_ARGUMENTS
*
* Return value:
* A valid pointer to an NSSPKIXAuthorityKeyIdentifier upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAuthorityKeyIdentifier *
nssPKIXAuthorityKeyIdentifier_Create
(
NSSArena *arenaOpt,
NSSPKIXKeyIdentifier *keyIdentifierOpt,
NSSPKIXGeneralNames *authorityCertIssuerOpt,
NSSPKIXCertificateSerialNumber *authorityCertSerialNumberOpt
);
/*
* nssPKIXAuthorityKeyIdentifier_Destroy
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_KEY_IDENTIFIER
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAuthorityKeyIdentifier_Destroy
(
NSSPKIXAuthorityKeyIdentifier *aki
);
/*
* nssPKIXAuthorityKeyIdentifier_Encode
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_KEY_IDENTIFIER
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
*
* Return value:
* A valid NSSBER pointer upon success
* NULL upon failure
*/
NSS_EXTERN NSSBER *
nssPKIXAuthorityKeyIdentifier_Encode
(
NSSPKIXAuthorityKeyIdentifier *aki,
NSSASN1EncodingType encoding,
NSSBER *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXAuthorityKeyIdentifier_HasKeyIdentifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_KEY_IDENTIFIER
*
* Return value:
* PR_TRUE if it has one
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXAuthorityKeyIdentifier_HasKeyIdentifier
(
NSSPKIXAuthorityKeyIdentifier *aki,
PRStatus *statusOpt
);
/*
* nssPKIXAuthorityKeyIdentifier_GetKeyIdentifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_KEY_IDENTIFIER
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_HAS_NO_KEY_IDENTIFIER
*
* Return value:
* A valid pointer to an NSSPKIXKeyIdentifier upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXKeyIdentifier *
nssPKIXAuthorityKeyIdentifier_GetKeyIdentifier
(
NSSPKIXAuthorityKeyIdentifier *aki,
NSSPKIXKeyIdentifier *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXAuthorityKeyIdentifier_SetKeyIdentifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_KEY_IDENTIFIER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ITEM
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAuthorityKeyIdentifier_SetKeyIdentifier
(
NSSPKIXAuthorityKeyIdentifier *aki,
NSSPKIXKeyIdentifier *keyIdentifier
);
/*
* nssPKIXAuthorityKeyIdentifier_RemoveKeyIdentifier
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_KEY_IDENTIFIER
* NSS_ERROR_HAS_NO_KEY_IDENTIFIER
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAuthorityKeyIdentifier_RemoveKeyIdentifier
(
NSSPKIXAuthorityKeyIdentifier *aki
);
/*
* nssPKIXAuthorityKeyIdentifier_HasAuthorityCertIssuerAndSerialNumber
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_KEY_IDENTIFIER
*
* Return value:
* PR_TRUE if it has them
* PR_FALSE if it doesn't
* PR_FALSE upon failure
*/
NSS_EXTERN PRBool
nssPKIXAuthorityKeyIdentifier_HasAuthorityCertIssuerAndSerialNumber
(
NSSPKIXAuthorityKeyIdentifier *aki,
PRStatus *statusOpt
);
/*
* nssPKIXAuthorityKeyIdentifier_RemoveAuthorityCertIssuerAndSerialNumber
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_KEY_IDENTIFIER
* NSS_ERROR_HAS_NO_AUTHORITY_CERT_ISSUER_AND_SERIAL_NUMBER
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAuthorityKeyIdentifier_RemoveAuthorityCertIssuerAndSerialNumber
(
NSSPKIXAuthorityKeyIdentifier *aki
);
/*
* nssPKIXAuthorityKeyIdentifier_GetAuthorityCertIssuer
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_KEY_IDENTIFIER
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_HAS_NO_AUTHORITY_CERT_ISSUER_AND_SERIAL_NUMBER
*
* Return value:
* A valid pointer to an NSSPKIXGeneralNames upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXGeneralNames *
nssPKIXAuthorityKeyIdentifier_GetAuthorityCertIssuer
(
NSSPKIXAuthorityKeyIdentifier *aki,
NSSArena *arenaOpt
);
/*
* nssPKIXAuthorityKeyIdentifier_GetAuthorityCertSerialNumber
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_KEY_IDENTIFIER
* NSS_ERROR_INVALID_ARENA
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_HAS_NO_AUTHORITY_CERT_ISSUER_AND_SERIAL_NUMBER
*
* Return value:
* A valid pointer to an NSSPKIXCertificateSerialNumber upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXCertificateSerialNumber *
nssPKIXAuthorityKeyIdentifier_GetAuthorityCertSerialNumber
(
NSSPKIXAuthorityKeyIdentifier *aki,
NSSPKIXCertificateSerialNumber *rvOpt,
NSSArena *arenaOpt
);
/*
* nssPKIXAuthorityKeyIdentifier_SetAuthorityCertIssuerAndSerialNumber
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_KEY_IDENTIFIER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_PKIX_GENERAL_NAMES
* NSS_ERROR_INVALID_ITEM
*
* Return value:
* PR_SUCCESS upon success
* PR_FAILURE upon failure
*/
NSS_EXTERN PRStatus
nssPKIXAuthorityKeyIdentifier_SetAuthorityCertIssuerAndSerialNumber
(
NSSPKIXAuthorityKeyIdentifier *aki,
NSSPKIXGeneralNames *issuer,
NSSPKIXCertificateSerialNumber *serialNumber
);
/*
* nssPKIXAuthorityKeyIdentifier_Equal
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_KEY_IDENTIFIER
*
* Return value:
* PR_TRUE if the two objects have equal values
* PR_FALSE otherwise
* PR_FALSE upon error
*/
NSS_EXTERN PRBool
nssPKIXAuthorityKeyIdentifier_Equal
(
NSSPKIXAuthorityKeyIdentifier *aki1,
NSSPKIXAuthorityKeyIdentifier *aki2,
PRStatus *statusOpt
);
/*
* nssPKIXAuthorityKeyIdentifier_Duplicate
*
* -- fgmr comments --
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_KEY_IDENTIFIER
* NSS_ERROR_NO_MEMORY
* NSS_ERROR_INVALID_ARENA
*
* Return value:
* A valid pointer to an NSSPKIXAuthorityKeyIdentifier upon success
* NULL upon failure
*/
NSS_EXTERN NSSPKIXAuthorityKeyIdentifier *
nssPKIXAuthorityKeyIdentifier_Duplicate
(
NSSPKIXAuthorityKeyIdentifier *aki,
NSSArena *arenaOpt
);
#ifdef DEBUG
/*
* nssPKIXAuthorityKeyIdentifier_verifyPointer
*
* This method is only present in debug builds.
*
* If the specified pointer is a valid pointer to an NSSPKIXAuthorityKeyIdentifier
* object, this routine will return PR_SUCCESS. Otherwise, it will
* put an error on the error stack and return PR_FAILURE.
*
* The error may be one of the following values:
* NSS_ERROR_INVALID_PKIX_AUTHORITY_KEY_IDENTIFIER
*
* Return value:
* PR_SUCCESS if the pointer is valid
* PR_FAILURE if it isn't
*/
NSS_EXTERN PRStatus
nssPKIXAuthorityKeyIdentifier_verifyPointer
(
NSSPKIXAuthorityKeyIdentifier *p
);
#endif /* DEBUG */
/*
* KeyUsage
*
* -- fgmr comments --
*
* From RFC 2459:
*
* KeyUsage ::= BIT STRING {
* digitalSignature (0),
* nonRepudiation (1),
* keyEncipherment (2),
* dataEncipherment (3),
* keyAgreement (4),
* keyCertSign (5),
* cRLSign (6),
* encipherOnly (7),
* decipherOnly (8) }
*
* The private calls for the type:
*
* nssPKIXKeyUsage_Decode
* nssPKIXKeyUsage_CreateFromUTF8
* nssPKIXKeyUsage_CreateFromValue
* nssPKIXKeyUsage_Destroy
* nssPKIXKeyUsage_Encode
* nssPKIXKeyUsage_GetUTF8Encoding
* nssPKIXKeyUsage_GetValue
* nssPKIXKeyUsage_SetValue
* { bitwise accessors? }
* nssPKIXKeyUsage_Equal
* nssPKIXKeyUsage_Duplicate
*
* In debug builds, the following call is available:
*
* nssPKIXKeyUsage_verifyPointer