nsspkix.h
上传用户:lyxiangda
上传日期:2007-01-12
资源大小:3042k
文件大小:512k
源码类别:

CA认证

开发平台:

WINDOWS

  1. /*
  2.  * NSSPKIXSubjectPublicKeyInfo_Destroy
  3.  *
  4.  * -- fgmr comments --
  5.  *
  6.  * The error may be one of the following values:
  7.  *  NSS_ERROR_INVALID_PKIX_SUBJECT_PUBLIC_KEY_INFO
  8.  *
  9.  * Return value:
  10.  *  PR_SUCCESS upon success
  11.  *  PR_FAILURE upon failure
  12.  */
  13. NSS_EXTERN PRStatus
  14. NSSPKIXSubjectPublicKeyInfo_Destroy
  15. (
  16.   NSSPKIXSubjectPublicKeyInfo *spki
  17. );
  18. /*
  19.  * NSSPKIXSubjectPublicKeyInfo_Encode
  20.  *
  21.  * -- fgmr comments --
  22.  *
  23.  * The error may be one of the following values:
  24.  *  NSS_ERROR_INVALID_PKIX_SUBJECT_PUBLIC_KEY_INFO
  25.  *
  26.  * Return value:
  27.  *  A valid NSSBER pointer upon success
  28.  *  NULL upon failure
  29.  */
  30. NSS_EXTERN NSSBER *
  31. NSSPKIXSubjectPublicKeyInfo_Encode
  32. (
  33.   NSSPKIXSubjectPublicKeyInfo *spki,
  34.   NSSASN1EncodingType encoding,
  35.   NSSBER *rvOpt,
  36.   NSSArena *arenaOpt
  37. );
  38. /*
  39.  * NSSPKIXSubjectPublicKeyInfo_GetAlgorithm
  40.  *
  41.  * -- fgmr comments --
  42.  *
  43.  * The error may be one of the following values:
  44.  *  NSS_ERROR_INVALID_PKIX_SUBJECT_PUBLIC_KEY_INFO
  45.  *  NSS_ERROR_INVALID_ARENA
  46.  *  NSS_ERROR_NO_MEMORY
  47.  *
  48.  * Return value:
  49.  *  A valid pointer to an NSSPKIXAlgorithmIdentifier upon success
  50.  *  NULL upon failure
  51.  */
  52. NSS_EXTERN NSSPKIXAlgorithmIdentifier *
  53. NSSPKIXSubjectPublicKeyInfo_GetAlgorithm
  54. (
  55.   NSSPKIXSubjectPublicKeyInfo *spki,
  56.   NSSArena *arenaOpt
  57. );
  58. /*
  59.  * NSSPKIXSubjectPublicKeyInfo_SetAlgorithm
  60.  *
  61.  * -- fgmr comments --
  62.  *
  63.  * The error may be one of the following values:
  64.  *  NSS_ERROR_INVALID_PKIX_SUBJECT_PUBLIC_KEY_INFO
  65.  *  NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
  66.  *
  67.  * Return value:
  68.  *  PR_SUCCESS upon success
  69.  *  PR_FAILURE upon failure
  70.  */
  71. NSS_EXTERN PRStatus
  72. NSSPKIXSubjectPublicKeyInfo_SetAlgorithm
  73. (
  74.   NSSPKIXSubjectPublicKeyInfo *spki,
  75.   NSSPKIXAlgorithmIdentifier *algid
  76. );
  77. /*
  78.  * NSSPKIXSubjectPublicKeyInfo_GetSubjectPublicKey
  79.  *
  80.  * -- fgmr comments --
  81.  *
  82.  * The error may be one of the following values:
  83.  *  NSS_ERROR_INVALID_PKIX_SUBJECT_PUBLIC_KEY_INFO
  84.  *  NSS_ERROR_INVALID_ARENA
  85.  *  NSS_ERROR_NO_MEMORY
  86.  *
  87.  * Return value:
  88.  *  A valid pointer to an NSSItem upon success
  89.  *  NULL upon failure
  90.  */
  91. NSS_EXTERN NSSItem *
  92. NSSPKIXSubjectPublicKeyInfo_GetSubjectPublicKey
  93. (
  94.   NSSPKIXSubjectPublicKeyInfo *spki,
  95.   NSSItem *spkOpt,
  96.   NSSArena *arenaOpt
  97. );
  98. /*
  99.  * NSSPKIXSubjectPublicKeyInfo_SetSubjectPublicKey
  100.  *
  101.  * -- fgmr comments --
  102.  *
  103.  * The error may be one of the following values:
  104.  *  NSS_ERROR_INVALID_PKIX_SUBJECT_PUBLIC_KEY_INFO
  105.  *  NSS_ERROR_INVALID_ITEM
  106.  *
  107.  * Return value:
  108.  *  PR_SUCCESS upon success
  109.  *  PR_FAILURE upon failure
  110.  */
  111. NSS_EXTERN PRStatus
  112. NSSPKIXSubjectPublicKeyInfo_SetSubjectPublicKey
  113. (
  114.   NSSPKIXSubjectPublicKeyInfo *spki,
  115.   NSSItem *spk
  116. );
  117. /*
  118.  * NSSPKIXSubjectPublicKeyInfo_Equal
  119.  *
  120.  * -- fgmr comments --
  121.  *
  122.  * The error may be one of the following values:
  123.  *  NSS_ERROR_INVALID_PKIX_SUBJECT_PUBLIC_KEY_INFO
  124.  *
  125.  * Return value:
  126.  *  PR_TRUE if the two objects have equal values
  127.  *  PR_FALSE otherwise
  128.  *  PR_FALSE upon error
  129.  */
  130. NSS_EXTERN PRBool
  131. NSSPKIXSubjectPublicKeyInfo_Equal
  132. (
  133.   NSSPKIXSubjectPublicKeyInfo *one,
  134.   NSSPKIXSubjectPublicKeyInfo *two,
  135.   PRStatus *statusOpt
  136. );
  137. /*
  138.  * NSSPKIXSubjectPublicKeyInfo_Duplicate
  139.  *
  140.  * -- fgmr comments --
  141.  *
  142.  * The error may be one of the following values:
  143.  *  NSS_ERROR_INVALID_PKIX_SUBJECT_PUBLIC_KEY_INFO
  144.  *  NSS_ERROR_INVALID_ARENA
  145.  *  NSS_ERROR_NO_MEMORY
  146.  *
  147.  * Return value:
  148.  *  A valid pointer to an NSSPKIXSubjectPublicKeyInfo upon success
  149.  *  NULL upon failure
  150.  */
  151. NSS_EXTERN NSSPKIXSubjectPublicKeyInfo *
  152. NSSPKIXSubjectPublicKeyInfo_Duplicate
  153. (
  154.   NSSPKIXSubjectPublicKeyInfo *spki,
  155.   NSSArena *arenaOpt
  156. );
  157. /*
  158.  * Extensions
  159.  *
  160.  * -- fgmr comments --
  161.  *
  162.  * From RFC 2459:
  163.  *
  164.  *  Extensions  ::=  SEQUENCE SIZE (1..MAX) OF Extension
  165.  *
  166.  */
  167. /* { FGMR } */
  168. /*
  169.  * Extension
  170.  *
  171.  * -- fgmr comments --
  172.  *
  173.  * From RFC 2459:
  174.  *
  175.  *  Extension  ::=  SEQUENCE  {
  176.  *       extnID      OBJECT IDENTIFIER,
  177.  *       critical    BOOLEAN DEFAULT FALSE,
  178.  *       extnValue   OCTET STRING  }
  179.  *
  180.  */
  181. /* { FGMR } */
  182. /*
  183.  * CertificateList
  184.  *
  185.  * -- fgmr comments --
  186.  *
  187.  * From RFC 2459:
  188.  *
  189.  *  CertificateList  ::=  SEQUENCE  {
  190.  *       tbsCertList          TBSCertList,
  191.  *       signatureAlgorithm   AlgorithmIdentifier,
  192.  *       signature            BIT STRING  }
  193.  *
  194.  * The public calls for the type:
  195.  *
  196.  *  NSSPKIXCertificateList_Decode
  197.  *  NSSPKIXCertificateList_Create
  198.  *  NSSPKIXCertificateList_Encode
  199.  *  NSSPKIXCertificateList_Destroy
  200.  *  NSSPKIXCertificateList_GetTBSCertList
  201.  *  NSSPKIXCertificateList_SetTBSCertList
  202.  *  NSSPKIXCertificateList_GetSignatureAlgorithm
  203.  *  NSSPKIXCertificateList_SetSignatureAlgorithm
  204.  *  NSSPKIXCertificateList_GetSignature
  205.  *  NSSPKIXCertificateList_SetSignature
  206.  *  NSSPKIXCertificateList_Equal
  207.  *  NSSPKIXCertificateList_Duplicate
  208.  *
  209.  */
  210. /*
  211.  * NSSPKIXCertificateList_Decode
  212.  *
  213.  * -- fgmr comments --
  214.  *
  215.  * The error may be one of the following values:
  216.  *  NSS_ERROR_INVALID_BER
  217.  *  NSS_ERROR_NO_MEMORY
  218.  *  NSS_ERROR_INVALID_ARENA
  219.  *
  220.  * Return value:
  221.  *  A valid pointer to an NSSPKIXCertificateList upon success
  222.  *  NULL upon failure
  223.  */
  224. NSS_EXTERN NSSPKIXCertificateList *
  225. NSSPKIXCertificateList_Decode
  226. (
  227.   NSSArena *arenaOpt,
  228.   NSSBER *ber
  229. );
  230. /*
  231.  * NSSPKIXCertificateList_Create
  232.  *
  233.  * -- fgmr comments --
  234.  *
  235.  * The error may be one of the following values:
  236.  *  NSS_ERROR_NO_MEMORY
  237.  *  NSS_ERROR_INVALID_ARENA
  238.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  239.  *  NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
  240.  *  NSS_ERROR_INVALID_ITEM
  241.  *
  242.  * Return value:
  243.  *  A valid pointer to an NSSPKIXCertificateList upon success
  244.  *  NULL upon failure
  245.  */
  246. NSS_EXTERN NSSPKIXCertificateList *
  247. NSSPKIXCertificateList_Create
  248. (
  249.   NSSArena *arenaOpt,
  250.   NSSPKIXTBSCertList *tbsCertList,
  251.   NSSPKIXAlgorithmIdentifier *sigAlg,
  252.   NSSItem *signature
  253. );
  254. /*
  255.  * NSSPKIXCertificateList_Destroy
  256.  *
  257.  * -- fgmr comments --
  258.  *
  259.  * The error may be one of the following values:
  260.  *  NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
  261.  *
  262.  * Return value:
  263.  *  PR_SUCCESS upon success
  264.  *  PR_FAILURE upon failure
  265.  */
  266. NSS_EXTERN PRStatus
  267. NSSPKIXCertificateList_Destroy
  268. (
  269.   NSSPKIXCertificateList *certList
  270. );
  271. /*
  272.  * NSSPKIXCertificateList_Encode
  273.  *
  274.  * -- fgmr comments --
  275.  *
  276.  * The error may be one of the following values:
  277.  *  NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
  278.  *  NSS_ERROR_INVALID_ARENA
  279.  *  NSS_ERROR_NO_MEMORY
  280.  *
  281.  * Return value:
  282.  *  A valid NSSBER pointer upon success
  283.  *  NULL upon failure
  284.  */
  285. NSS_EXTERN NSSBER *
  286. NSSPKIXCertificateList_Encode
  287. (
  288.   NSSPKIXCertificateList *certList,
  289.   NSSASN1EncodingType encoding,
  290.   NSSBER *rvOpt,
  291.   NSSArena *arenaOpt
  292. );
  293. /*
  294.  * NSSPKIXCertificateList_GetTBSCertList
  295.  *
  296.  * -- fgmr comments --
  297.  *
  298.  * The error may be one of the following values:
  299.  *  NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
  300.  *  NSS_ERROR_INVALID_ARENA
  301.  *  NSS_ERROR_NO_MEMORY
  302.  *
  303.  * Return value:
  304.  *  A valid pointer to an NSSPKIXTBSCertList upon success
  305.  *  NULL upon failure
  306.  */
  307. NSS_EXTERN NSSPKIXTBSCertList *
  308. NSSPKIXCertificateList_GetTBSCertList
  309. (
  310.   NSSPKIXCertificateList *certList,
  311.   NSSArena *arenaOpt
  312. );
  313. /*
  314.  * NSSPKIXCertificateList_SetTBSCertList
  315.  *
  316.  * -- fgmr comments --
  317.  *
  318.  * The error may be one of the following values:
  319.  *  NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
  320.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  321.  *  NSS_ERROR_NO_MEMORY
  322.  *
  323.  * Return value:
  324.  *  PR_SUCCESS upon success
  325.  *  PR_FAILURE upon failure
  326.  */
  327. NSS_EXTERN PRStatus
  328. NSSPKIXCertificateList_SetTBSCertList
  329. (
  330.   NSSPKIXCertificateList *certList,
  331.   NSSPKIXTBSCertList *tbsCertList
  332. );
  333. /*
  334.  * NSSPKIXCertificateList_GetSignatureAlgorithm
  335.  *
  336.  * -- fgmr comments --
  337.  *
  338.  * The error may be one of the following values:
  339.  *  NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
  340.  *  NSS_ERROR_INVALID_ARENA
  341.  *  NSS_ERROR_NO_MEMORY
  342.  *
  343.  * Return value:
  344.  *  A valid pointer to an NSSPKIXAlgorithmIdentifier upon success
  345.  *  NULL upon failure
  346.  */
  347. NSS_EXTERN NSSPKIXAlgorithmIdentifier *
  348. NSSPKIXCertificateList_GetSignatureAlgorithm
  349. (
  350.   NSSPKIXCertificateList *certList,
  351.   NSSArena *arenaOpt
  352. );
  353. /*
  354.  * NSSPKIXCertificateList_SetSignatureAlgorithm
  355.  *
  356.  * -- fgmr comments --
  357.  *
  358.  * The error may be one of the following values:
  359.  *  NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
  360.  *  NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
  361.  *  NSS_ERROR_NO_MEMORY
  362.  *
  363.  * Return value:
  364.  *  PR_SUCCESS upon success
  365.  *  PR_FAILURE upon failure
  366.  */
  367. NSS_EXTERN PRStatus
  368. NSSPKIXCertificateList_SetSignatureAlgorithm
  369. (
  370.   NSSPKIXCertificateList *certList,
  371.   NSSPKIXAlgorithmIdentifier *sigAlg
  372. );
  373. /*
  374.  * NSSPKIXCertificateList_GetSignature
  375.  *
  376.  * -- fgmr comments --
  377.  *
  378.  * The error may be one of the following values:
  379.  *  NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
  380.  *  NSS_ERROR_INVALID_ARENA
  381.  *  NSS_ERROR_NO_MEMORY
  382.  *
  383.  * Return value:
  384.  *  A valid pointer to an NSSItem upon success
  385.  *  NULL upon failure
  386.  */
  387. NSS_EXTERN NSSItem *
  388. NSSPKIXCertificateList_GetSignature
  389. (
  390.   NSSPKIXCertificateList *certList,
  391.   NSSItem *rvOpt,
  392.   NSSArena *arenaOpt
  393. );
  394. /*
  395.  * NSSPKIXCertificateList_SetSignature
  396.  *
  397.  * -- fgmr comments --
  398.  *
  399.  * The error may be one of the following values:
  400.  *  NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
  401.  *  NSS_ERROR_INVALID_ITEM
  402.  *  NSS_ERROR_NO_MEMORY
  403.  *
  404.  * Return value:
  405.  *  PR_SUCCESS upon success
  406.  *  PR_FAILURE upon failure
  407.  */
  408. NSS_EXTERN PRStatus
  409. NSSPKIXCertificateList_SetSignature
  410. (
  411.   NSSPKIXCertificateList *certList,
  412.   NSSItem *sig
  413. );
  414. /*
  415.  * NSSPKIXCertificateList_Equal
  416.  *
  417.  * -- fgmr comments --
  418.  *
  419.  * The error may be one of the following values:
  420.  *  NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
  421.  *
  422.  * Return value:
  423.  *  PR_TRUE if the two objects have equal values
  424.  *  PR_FALSE otherwise
  425.  *  PR_FALSE upon error
  426.  */
  427. NSS_EXTERN PRBool
  428. NSSPKIXCertificateList_Equal
  429. (
  430.   NSSPKIXCertificateList *one,
  431.   NSSPKIXCertificateList *two,
  432.   PRStatus *statusOpt
  433. );
  434. /*
  435.  * NSSPKIXCertificateList_Duplicate
  436.  *
  437.  * -- fgmr comments --
  438.  *
  439.  * The error may be one of the following values:
  440.  *  NSS_ERROR_INVALID_PKIX_CERTIFICATE_LIST
  441.  *  NSS_ERROR_INVALID_ARENA
  442.  *  NSS_ERROR_NO_MEMORY
  443.  *
  444.  * Return value:
  445.  *  A valid pointer to an NSSPKIXCertificateList upon success
  446.  *  NULL upon failure
  447.  */
  448. NSS_EXTERN NSSPKIXCertificateList *
  449. NSSPKIXCertificateList_Duplicate
  450. (
  451.   NSSPKIXCertificateList *certList,
  452.   NSSArena *arenaOpt
  453. );
  454. /*
  455.  * TBSCertList
  456.  *
  457.  * -- fgmr comments --
  458.  *
  459.  * From RFC 2459:
  460.  *
  461.  *  TBSCertList  ::=  SEQUENCE  {
  462.  *       version                 Version OPTIONAL,
  463.  *                                    -- if present, shall be v2
  464.  *       signature               AlgorithmIdentifier,
  465.  *       issuer                  Name,
  466.  *       thisUpdate              Time,
  467.  *       nextUpdate              Time OPTIONAL,
  468.  *       revokedCertificates     SEQUENCE OF SEQUENCE  {
  469.  *            userCertificate         CertificateSerialNumber,
  470.  *            revocationDate          Time,
  471.  *            crlEntryExtensions      Extensions OPTIONAL
  472.  *                                           -- if present, shall be v2
  473.  *                                 }  OPTIONAL,
  474.  *       crlExtensions           [0] Extensions OPTIONAL
  475.  *                                           -- if present, shall be v2 -- }
  476.  *
  477.  * The public calls for the type:
  478.  *
  479.  *  NSSPKIXTBSCertList_Decode
  480.  *  NSSPKIXTBSCertList_Create
  481.  *  NSSPKIXTBSCertList_Destroy
  482.  *  NSSPKIXTBSCertList_Encode
  483.  *  NSSPKIXTBSCertList_GetVersion
  484.  *  NSSPKIXTBSCertList_SetVersion
  485.  *  NSSPKIXTBSCertList_GetSignature
  486.  *  NSSPKIXTBSCertList_SetSignature
  487.  *  NSSPKIXTBSCertList_GetIssuer
  488.  *  NSSPKIXTBSCertList_SetIssuer
  489.  *  NSSPKIXTBSCertList_GetThisUpdate
  490.  *  NSSPKIXTBSCertList_SetThisUpdate
  491.  *  NSSPKIXTBSCertList_HasNextUpdate
  492.  *  NSSPKIXTBSCertList_GetNextUpdate
  493.  *  NSSPKIXTBSCertList_SetNextUpdate
  494.  *  NSSPKIXTBSCertList_RemoveNextUpdate
  495.  *  NSSPKIXTBSCertList_GetRevokedCertificates
  496.  *  NSSPKIXTBSCertList_SetRevokedCertificates
  497.  *  NSSPKIXTBSCertList_HasCrlExtensions
  498.  *  NSSPKIXTBSCertList_GetCrlExtensions
  499.  *  NSSPKIXTBSCertList_SetCrlExtensions
  500.  *  NSSPKIXTBSCertList_RemoveCrlExtensions
  501.  *  NSSPKIXTBSCertList_Equal
  502.  *  NSSPKIXTBSCertList_Duplicate
  503.  *
  504.  */
  505. /*
  506.  * NSSPKIXTBSCertList_Decode
  507.  *
  508.  * -- fgmr comments --
  509.  *
  510.  * The error may be one of the following values:
  511.  *  NSS_ERROR_INVALID_BER
  512.  *  NSS_ERROR_NO_MEMORY
  513.  *  NSS_ERROR_INVALID_ARENA
  514.  *
  515.  * Return value:
  516.  *  A valid pointer to an NSSPKIXTBSCertList upon success
  517.  *  NULL upon failure
  518.  */
  519. NSS_EXTERN NSSPKIXTBSCertList *
  520. NSSPKIXTBSCertList_Decode
  521. (
  522.   NSSArena *arenaOpt,
  523.   NSSBER *ber
  524. );
  525. /*
  526.  * NSSPKIXTBSCertList_Create
  527.  *
  528.  * -- fgmr comments --
  529.  *
  530.  * The error may be one of the following values:
  531.  *  NSS_ERROR_NO_MEMORY
  532.  *  NSS_ERROR_INVALID_ARENA
  533.  *  NSS_ERROR_INVALID_PKIX_VERSION
  534.  *  NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
  535.  *  NSS_ERROR_INVALID_PKIX_NAME
  536.  *  NSS_ERROR_INVALID_PKIX_TIME
  537.  *  (something for the times being out of order?)
  538.  *  NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATES
  539.  *  NSS_ERROR_INVALID_PKIX_EXTENSIONS
  540.  *
  541.  * Return value:
  542.  *  A valid pointer to an NSSPKIXTBSCertList upon success
  543.  *  NULL upon failure
  544.  */
  545. NSS_EXTERN NSSPKIXTBSCertList *
  546. NSSPKIXTBSCertList_Create
  547. (
  548.   NSSArena *arenaOpt,
  549.   NSSPKIXVersion version,
  550.   NSSPKIXAlgorithmIdentifier *signature,
  551.   NSSPKIXName *issuer,
  552.   NSSPKIXTime thisUpdate,
  553.   NSSPKIXTime nextUpdateOpt,
  554.   NSSPKIXrevokedCertificates *revokedCerts,
  555.   NSSPKIXExtensions *crlExtensionsOpt
  556. );
  557. /*
  558.  * NSSPKIXTBSCertList_Destroy
  559.  *
  560.  * -- fgmr comments --
  561.  *
  562.  * The error may be one of the following values:
  563.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  564.  *
  565.  * Return value:
  566.  *  PR_SUCCESS upon success
  567.  *  PR_FAILURE upon failure
  568.  */
  569. NSS_EXTERN PRStatus
  570. NSSPKIXTBSCertList_Destroy
  571. (
  572.   NSSPKIXTBSCertList *certList
  573. );
  574. /*
  575.  * NSSPKIXTBSCertList_Encode
  576.  *
  577.  * -- fgmr comments --
  578.  *
  579.  * The error may be one of the following values:
  580.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  581.  *  NSS_ERROR_INVALID_ARENA
  582.  *  NSS_ERROR_NO_MEMORY
  583.  *
  584.  * Return value:
  585.  *  A valid NSSBER pointer upon success
  586.  *  NULL upon failure
  587.  */
  588. NSS_EXTERN NSSBER *
  589. NSSPKIXTBSCertList_Encode
  590. (
  591.   NSSPKIXTBSCertList *certList,
  592.   NSSASN1EncodingType encoding,
  593.   NSSBER *rvOpt,
  594.   NSSArena *arenaOpt
  595. );
  596. /*
  597.  * NSSPKIXTBSCertList_GetVersion
  598.  *
  599.  * -- fgmr comments --
  600.  *
  601.  * The error may be one of the following values:
  602.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  603.  *  NSS_ERROR_VALUE_OUT_OF_RANGE
  604.  *
  605.  * Return value:
  606.  *  A valid element of the NSSPKIXVersion enumeration upon success
  607.  *  NSSPKIXVersion_NSSinvalid (-1) upon failure
  608.  */
  609. NSS_EXTERN NSSPKIXVersion
  610. NSSPKIXTBSCertList_GetVersion
  611. (
  612.   NSSPKIXTBSCertList *certList
  613. );
  614. /*
  615.  * NSSPKIXTBSCertList_SetVersion
  616.  *
  617.  * -- fgmr comments --
  618.  *
  619.  * The error may be one of the following values:
  620.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  621.  *  NSS_ERROR_INVALID_PKIX_VERSION
  622.  *
  623.  * Return value:
  624.  *  PR_SUCCESS upon success
  625.  *  PR_FAILURE upon failure
  626.  */
  627. NSS_EXTERN PRStatus
  628. NSSPKIXTBSCertList_SetVersion
  629. (
  630.   NSSPKIXTBSCertList *certList,
  631.   NSSPKIXVersion version
  632. );
  633. /*
  634.  * NSSPKIXTBSCertList_GetSignature
  635.  *
  636.  * -- fgmr comments --
  637.  *
  638.  * The error may be one of the following values:
  639.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  640.  *  NSS_ERROR_INVALID_ARENA
  641.  *  NSS_ERROR_NO_MEMORY
  642.  *
  643.  * Return value:
  644.  *  A valid pointer to an NSSPKIXAlgorithmIdentifier upon success
  645.  *  NULL upon failure
  646.  */
  647. NSS_EXTERN NSSPKIXAlgorithmIdentifier *
  648. NSSPKIXTBSCertList_GetSignature
  649. (
  650.   NSSPKIXTBSCertList *certList,
  651.   NSSArena *arenaOpt
  652. );
  653. /*
  654.  * NSSPKIXTBSCertList_SetSignature
  655.  *
  656.  * -- fgmr comments --
  657.  *
  658.  * The error may be one of the following values:
  659.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  660.  *  NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
  661.  *  NSS_ERROR_NO_MEMORY
  662.  *
  663.  * Return value:
  664.  *  PR_SUCCESS upon success
  665.  *  PR_FAILURE upon failure
  666.  */
  667. NSS_EXTERN PRStatus
  668. NSSPKIXTBSCertList_SetSignature
  669. (
  670.   NSSPKIXTBSCertList *certList,
  671.   NSSPKIXAlgorithmIdentifier *algid,
  672. );
  673. /*
  674.  * NSSPKIXTBSCertList_GetIssuer
  675.  *
  676.  * -- fgmr comments --
  677.  *
  678.  * The error may be one of the following values:
  679.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  680.  *  NSS_ERROR_INVALID_ARENA
  681.  *  NSS_ERROR_NO_MEMORY
  682.  *
  683.  * Return value:
  684.  *  A valid pointer to an NSSPKIXName upon success
  685.  *  NULL upon failure
  686.  */
  687. NSS_EXTERN NSSPKIXName *
  688. NSSPKIXTBSCertList_GetIssuer
  689. (
  690.   NSSPKIXTBSCertList *certList,
  691.   NSSArena *arenaOpt
  692. );
  693. /*
  694.  * NSSPKIXTBSCertList_SetIssuer
  695.  *
  696.  * -- fgmr comments --
  697.  *
  698.  * The error may be one of the following values:
  699.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  700.  *  NSS_ERROR_INVALID_PKIX_NAME
  701.  *  NSS_ERROR_NO_MEMORY
  702.  *
  703.  * Return value:
  704.  *  PR_SUCCESS upon success
  705.  *  PR_FAILURE upon failure
  706.  */
  707. NSS_EXTERN PRStatus
  708. NSSPKIXTBSCertList_SetIssuer
  709. (
  710.   NSSPKIXTBSCertList *certList,
  711.   NSSPKIXName *issuer
  712. );
  713. /*
  714.  * NSSPKIXTBSCertList_GetThisUpdate
  715.  *
  716.  * -- fgmr comments --
  717.  *
  718.  * The error may be one of the following values:
  719.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  720.  *  NSS_ERROR_VALUE_OUT_OF_RANGE
  721.  *
  722.  * Return value:
  723.  *  A valid NSSPKIXTime upon success
  724.  *  {we need to rethink NSSPKIXTime}
  725.  */
  726. NSS_EXTERN NSSPKIXTime
  727. NSSPKIXTBSCertList_GetThisUpdate
  728. (
  729.   NSSPKIXTBSCertList *certList
  730. );
  731. /*
  732.  * NSSPKIXTBSCertList_SetThisUpdate
  733.  *
  734.  * -- fgmr comments --
  735.  *
  736.  * The error may be one of the following values:
  737.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  738.  *  NSS_ERROR_VALUE_TOO_LARGE
  739.  *
  740.  * Return value:
  741.  *  PR_SUCCESS upon success
  742.  *  PR_FAILURE upon failure
  743.  */
  744. NSS_EXTERN PRStatus
  745. NSSPKIXTBSCertList_SetThisUpdate
  746. (
  747.   NSSPKIXTBSCertList *certList,
  748.   NSSPKIXTime thisUpdate
  749. );
  750. /*
  751.  * NSSPKIXTBSCertList_HasNextUpdate
  752.  *
  753.  * -- fgmr comments --
  754.  *
  755.  * The error may be one of the following values:
  756.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  757.  *
  758.  * Return value:
  759.  *  PR_TRUE if it has one
  760.  *  PR_FALSE if it doesn't
  761.  *  PR_FALSE upon failure
  762.  */
  763. NSS_EXTERN PRBool
  764. NSSPKIXTBSCertList_HasNextUpdate
  765. (
  766.   NSSPKIXTBSCertList *certList,
  767.   PRStatus *statusOpt
  768. );
  769. /*
  770.  * NSSPKIXTBSCertList_GetNextUpdate
  771.  *
  772.  * -- fgmr comments --
  773.  *
  774.  * The error may be one of the following values:
  775.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  776.  *  NSS_ERROR_VALUE_OUT_OF_RANGE
  777.  *
  778.  * Return value:
  779.  *  A valid NSSPKIXTime upon success
  780.  *  {we need to rethink NSSPKIXTime}
  781.  */
  782. NSS_EXTERN NSSPKIXTime
  783. NSSPKIXTBSCertList_GetNextUpdate
  784. (
  785.   NSSPKIXTBSCertList *certList
  786. );
  787. /*
  788.  * NSSPKIXTBSCertList_SetNextUpdate
  789.  *
  790.  * -- fgmr comments --
  791.  *
  792.  * The error may be one of the following values:
  793.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  794.  *  NSS_ERROR_VALUE_TOO_SMALL
  795.  *
  796.  * Return value:
  797.  *  PR_SUCCESS upon success
  798.  *  PR_FAILURE upon failure
  799.  */
  800. NSS_EXTERN PRStatus
  801. NSSPKIXTBSCertList_SetNextUpdate
  802. (
  803.   NSSPKIXTBSCertList *certList,
  804.   NSSPKIXTime nextUpdate
  805. );
  806. /*
  807.  * NSSPKIXTBSCertList_RemoveNextUpdate
  808.  *
  809.  * -- fgmr comments --
  810.  *
  811.  * The error may be one of the following values:
  812.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  813.  *  NSS_ERROR_HAS_NO_NEXT_UPDATE
  814.  *
  815.  * Return value:
  816.  *  PR_SUCCESS upon success
  817.  *  PR_FAILURE upon failure
  818.  */
  819. NSS_EXTERN PRStatus
  820. NSSPKIXTBSCertList_RemoveNextUpdate
  821. (
  822.   NSSPKIXTBSCertList *certList
  823. );
  824. /*
  825.  * NSSPKIXTBSCertList_GetRevokedCertificates
  826.  *
  827.  * -- fgmr comments --
  828.  *
  829.  * The error may be one of the following values:
  830.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  831.  *  NSS_ERROR_INVALID_ARENA
  832.  *  NSS_ERROR_NO_MEMORY
  833.  *
  834.  * Return value:
  835.  *  A valid pointer to an NSSPKIXrevokedCertificates upon succes
  836.  *  NULL upon failure
  837.  */
  838. NSS_EXTERN NSSPKIXrevokedCertificates *
  839. NSSPKIXTBSCertList_GetRevokedCertificates
  840. (
  841.   NSSPKIXTBSCertList *certList,
  842.   NSSArena *arenaOpt
  843. );
  844. /*
  845.  * NSSPKIXTBSCertList_SetRevokedCertificates
  846.  *
  847.  * -- fgmr comments --
  848.  *
  849.  * The error may be one of the following values:
  850.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  851.  *  NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATES
  852.  *  NSS_ERROR_NO_MEMORY
  853.  *
  854.  * Return value:
  855.  *  PR_SUCCESS upon success
  856.  *  PR_FAILURE upon failure
  857.  */
  858. NSS_EXTERN PRStatus
  859. NSSPKIXTBSCertList_SetRevokedCertificates
  860. (
  861.   NSSPKIXTBSCertList *certList,
  862.   NSSPKIXrevokedCertificates *revoked
  863. );
  864. /*
  865.  * NSSPKIXTBSCertList_HasCrlExtensions
  866.  *
  867.  * -- fgmr comments --
  868.  *
  869.  * The error may be one of the following values:
  870.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  871.  *
  872.  * Return value:
  873.  *  PR_TRUE if it has one
  874.  *  PR_FALSE if it doesn't
  875.  *  PR_FALSE upon failure
  876.  */
  877. NSS_EXTERN PRBool
  878. NSSPKIXTBSCertList_HasCrlExtensions
  879. (
  880.   NSSPKIXTBSCertList *certList,
  881.   PRStatus *statusOpt
  882. );
  883. /*
  884.  * NSSPKIXTBSCertList_GetCrlExtensions
  885.  *
  886.  * -- fgmr comments --
  887.  *
  888.  * The error may be one of the following values:
  889.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  890.  *  NSS_ERROR_INVALID_ARENA
  891.  *  NSS_ERROR_NO_MEMORY
  892.  *
  893.  * Return value:
  894.  *  A valid pointer to an NSSPKIXExtensions upon success
  895.  *  NULL upon failure
  896.  */
  897. NSS_EXTERN NSSPKIXExtensions *
  898. NSSPKIXTBSCertList_GetCrlExtensions
  899. (
  900.   NSSPKIXTBSCertList *certList,
  901.   NSSArena *arenaOpt
  902. );
  903. /*
  904.  * NSSPKIXTBSCertList_SetCrlExtensions
  905.  *
  906.  * -- fgmr comments --
  907.  *
  908.  * The error may be one of the following values:
  909.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  910.  *  NSS_ERROR_INVALID_PKIX_EXTENSIONS
  911.  *  NSS_ERROR_NO_MEMORY
  912.  *
  913.  * Return value:
  914.  *  PR_SUCCESS upon success
  915.  *  PR_FAILURE upon failure
  916.  */
  917. NSS_EXTERN PRStatus
  918. NSSPKIXTBSCertList_SetCrlExtensions
  919. (
  920.   NSSPKIXTBSCertList *certList,
  921.   NSSPKIXExtensions *extensions
  922. );
  923. /*
  924.  * NSSPKIXTBSCertList_RemoveCrlExtensions
  925.  *
  926.  * -- fgmr comments --
  927.  *
  928.  * The error may be one of the following values:
  929.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  930.  *  NSS_ERROR_HAS_NO_EXTENSIONS
  931.  *
  932.  * Return value:
  933.  *  PR_SUCCESS upon success
  934.  *  PR_FAILURE upon failure
  935.  */
  936. NSS_EXTERN PRStatus
  937. NSSPKIXTBSCertList_RemoveCrlExtensions
  938. (
  939.   NSSPKIXTBSCertList *certList
  940. );
  941. /*
  942.  * NSSPKIXTBSCertList_Equal
  943.  *
  944.  * -- fgmr comments --
  945.  *
  946.  * The error may be one of the following values:
  947.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  948.  *
  949.  * Return value:
  950.  *  PR_TRUE if the two objects have equal values
  951.  *  PR_FALSE otherwise
  952.  *  PR_FALSE upon error
  953.  */
  954. NSS_EXTERN PRBool
  955. NSSPKIXTBSCertList_Equal
  956. (
  957.   NSSPKIXTBSCertList *one,
  958.   NSSPKIXTBSCertList *two,
  959.   PRStatus *statusOpt
  960. );
  961. /*
  962.  * NSSPKIXTBSCertList_Duplicate
  963.  *
  964.  * -- fgmr comments --
  965.  *
  966.  * The error may be one of the following values:
  967.  *  NSS_ERROR_INVALID_PKIX_TBS_CERT_LIST
  968.  *  NSS_ERROR_INVALID_ARENA
  969.  *  NSS_ERROR_NO_MEMORY
  970.  *
  971.  * Return value:
  972.  *  A valid pointer to an NSSPKIXTBSCertList upon success
  973.  *  NULL upon failure
  974.  */
  975. NSS_EXTERN NSSPKIXTBSCertList *
  976. NSSPKIXTBSCertList_Duplicate
  977. (
  978.   NSSPKIXTBSCertList *certList,
  979.   NSSArena *arenaOpt
  980. );
  981. /*
  982.  * revokedCertificates
  983.  *
  984.  * This is a "helper type" to simplify handling of TBSCertList objects.
  985.  *
  986.  *       revokedCertificates     SEQUENCE OF SEQUENCE  {
  987.  *            userCertificate         CertificateSerialNumber,
  988.  *            revocationDate          Time,
  989.  *            crlEntryExtensions      Extensions OPTIONAL
  990.  *                                           -- if present, shall be v2
  991.  *                                 }  OPTIONAL,
  992.  *
  993.  * The public calls for the type:
  994.  *
  995.  *  NSSPKIXrevokedCertificates_Decode
  996.  *  NSSPKIXrevokedCertificates_Create
  997.  *  NSSPKIXrevokedCertificates_Encode
  998.  *  NSSPKIXrevokedCertificates_Destroy
  999.  *  NSSPKIXrevokedCertificates_GetRevokedCertificateCount
  1000.  *  NSSPKIXrevokedCertificates_GetRevokedCertificates
  1001.  *  NSSPKIXrevokedCertificates_SetRevokedCertificates
  1002.  *  NSSPKIXrevokedCertificates_GetRevokedCertificate
  1003.  *  NSSPKIXrevokedCertificates_SetRevokedCertificate
  1004.  *  NSSPKIXrevokedCertificates_InsertRevokedCertificate
  1005.  *  NSSPKIXrevokedCertificates_AppendRevokedCertificate
  1006.  *  NSSPKIXrevokedCertificates_RemoveRevokedCertificate
  1007.  *  NSSPKIXrevokedCertificates_Equal
  1008.  *  NSSPKIXrevokedCertificates_Duplicate
  1009.  *
  1010.  */
  1011. /*
  1012.  * NSSPKIXrevokedCertificates_Decode
  1013.  *
  1014.  * -- fgmr comments --
  1015.  *
  1016.  * The error may be one of the following values:
  1017.  *  NSS_ERROR_INVALID_BER
  1018.  *  NSS_ERROR_NO_MEMORY
  1019.  *  NSS_ERROR_INVALID_ARENA
  1020.  *
  1021.  * Return value:
  1022.  *  A valid pointer to an NSSPKIXrevokedCertificates upon success
  1023.  *  NULL upon failure
  1024.  */
  1025. NSS_EXTERN NSSPKIXrevokedCertificates *
  1026. NSSPKIXrevokedCertificates_Decode
  1027. (
  1028.   NSSArena *arenaOpt,
  1029.   NSSBER *ber
  1030. );
  1031. /*
  1032.  * NSSPKIXrevokedCertificates_Create
  1033.  *
  1034.  * -- fgmr comments --
  1035.  *
  1036.  * The error may be one of the following values:
  1037.  *  NSS_ERROR_NO_MEMORY
  1038.  *  NSS_ERROR_INVALID_ARENA
  1039.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATE
  1040.  *
  1041.  * Return value:
  1042.  *  A valid pointer to an NSSPKIXrevokedCertificates upon success
  1043.  *  NULL upon failure
  1044.  */
  1045. NSS_EXTERN NSSPKIXrevokedCertificates *
  1046. NSSPKIXrevokedCertificates_Create
  1047. (
  1048.   NSSArena *arenaOpt,
  1049.   NSSPKIXrevokedCertificate *rc1,
  1050.   ...
  1051. );
  1052. /*
  1053.  * NSSPKIXrevokedCertificates_Destroy
  1054.  *
  1055.  * -- fgmr comments --
  1056.  *
  1057.  * The error may be one of the following values:
  1058.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATES
  1059.  *
  1060.  * Return value:
  1061.  *  PR_SUCCESS upon success
  1062.  *  PR_FAILURE upon failure
  1063.  */
  1064. NSS_EXTERN PRStatus
  1065. NSSPKIXrevokedCertificates_Destroy
  1066. (
  1067.   NSSPKIXrevokedCertificates *rcs
  1068. );
  1069. /*
  1070.  * NSSPKIXrevokedCertificates_Encode
  1071.  *
  1072.  * -- fgmr comments --
  1073.  *
  1074.  * The error may be one of the following values:
  1075.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATES
  1076.  *  NSS_ERROR_INVALID_ARENA
  1077.  *  NSS_ERROR_NO_MEMORY
  1078.  *
  1079.  * Return value:
  1080.  *  A valid NSSBER pointer upon success
  1081.  *  NULL upon failure
  1082.  */
  1083. NSS_EXTERN NSSBER *
  1084. NSSPKIXrevokedCertificates_Encode
  1085. (
  1086.   NSSPKIXrevokedCertificates *rcs,
  1087.   NSSASN1EncodingType encoding,
  1088.   NSSBER *rvOpt,
  1089.   NSSArena *arenaOpt
  1090. );
  1091. /*
  1092.  * NSSPKIXrevokedCertificates_GetRevokedCertificateCount
  1093.  *
  1094.  * -- fgmr comments --
  1095.  *
  1096.  * The error may be one of the following values:
  1097.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATES
  1098.  *  NSS_ERROR_VALUE_OUT_OF_RANGE
  1099.  *
  1100.  * Return value:
  1101.  *  Nonnegative integer upon success
  1102.  *  -1 upon failure.
  1103.  */
  1104. NSS_EXTERN PRInt32
  1105. NSSPKIXrevokedCertificates_GetRevokedCertificateCount
  1106. (
  1107.   NSSPKIXrevokedCertificates *rcs
  1108. );
  1109. /*
  1110.  * NSSPKIXrevokedCertificates_GetRevokedCertificates
  1111.  *
  1112.  * -- fgmr comments --
  1113.  *
  1114.  * The error may be one of the following values:
  1115.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATES
  1116.  *  NSS_ERROR_INVALID_ARENA
  1117.  *  NSS_ERROR_NO_MEMORY
  1118.  *  NSS_ERROR_ARRAY_TOO_SMALL
  1119.  *
  1120.  * Return value:
  1121.  *  A valid pointer to an array of NSSPKIXrevokedCertificate pointers
  1122.  *      upon success
  1123.  *  NULL upon failure
  1124.  */
  1125. NSS_EXTERN NSSPKIXrevokedCertificate **
  1126. NSSPKIXrevokedCertificates_GetRevokedCertificates
  1127. (
  1128.   NSSPKIXrevokedCertificates *rcs,
  1129.   NSSPKIXrevokedCertificate *rvOpt[],
  1130.   PRInt32 limit,
  1131.   NSSArena *arenaOpt
  1132. );
  1133. /*
  1134.  * NSSPKIXrevokedCertificates_SetRevokedCertificates
  1135.  *
  1136.  * -- fgmr comments --
  1137.  *
  1138.  * The error may be one of the following values:
  1139.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATES
  1140.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATE
  1141.  *  NSS_ERROR_NO_MEMORY
  1142.  *
  1143.  * Return value:
  1144.  *  PR_SUCCESS upon success
  1145.  *  PR_FAILURE upon failure
  1146.  */
  1147. NSS_EXTERN PRStatus
  1148. NSSPKIXrevokedCertificates_SetRevokedCertificates
  1149. (
  1150.   NSSPKIXrevokedCertificates *rcs,
  1151.   NSSPKIXrevokedCertificate *rc[],
  1152.   PRInt32 countOpt
  1153. );
  1154. /*
  1155.  * NSSPKIXrevokedCertificates_GetRevokedCertificate
  1156.  *
  1157.  * -- fgmr comments --
  1158.  *
  1159.  * The error may be one of the following values:
  1160.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATES
  1161.  *  NSS_ERROR_VALUE_OUT_OF_RANGE
  1162.  *  NSS_ERROR_NO_MEMORY
  1163.  *  NSS_ERROR_INVALID_ARENA
  1164.  *
  1165.  * Return value:
  1166.  *  A valid pointer to an NSSPKIXrevokedCertificate upon success
  1167.  *  NULL upon failure
  1168.  */
  1169. NSS_EXTERN NSSPKIXrevokedCertificate *
  1170. NSSPKIXrevokedCertificates_GetRevokedCertificate
  1171. (
  1172.   NSSPKIXrevokedCertificates *rcs,
  1173.   PRInt32 i,
  1174.   NSSArena *arenaOpt
  1175. );
  1176. /*
  1177.  * NSSPKIXrevokedCertificates_SetRevokedCertificate
  1178.  *
  1179.  * -- fgmr comments --
  1180.  *
  1181.  * The error may be one of the following values:
  1182.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATES
  1183.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATE
  1184.  *  NSS_ERROR_VALUE_OUT_OF_RANGE
  1185.  *  NSS_ERROR_NO_MEMORY
  1186.  *
  1187.  * Return value:
  1188.  *  PR_SUCCESS upon success
  1189.  *  PR_FAILURE upon failure
  1190.  */
  1191. NSS_EXTERN PRStatus
  1192. NSSPKIXrevokedCertificates_SetRevokedCertificate
  1193. (
  1194.   NSSPKIXrevokedCertificates *rcs,
  1195.   PRInt32 i,
  1196.   NSSPKIXrevokedCertificate *rc
  1197. );
  1198. /*
  1199.  * NSSPKIXrevokedCertificates_InsertRevokedCertificate
  1200.  *
  1201.  * -- fgmr comments --
  1202.  *
  1203.  * The error may be one of the following values:
  1204.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATES
  1205.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATE
  1206.  *  NSS_ERROR_VALUE_OUT_OF_RANGE
  1207.  *  NSS_ERROR_NO_MEMORY
  1208.  *
  1209.  * Return value:
  1210.  *  PR_SUCCESS upon success
  1211.  *  PR_FAILURE upon failure
  1212.  */
  1213. NSS_EXTERN PRStatus
  1214. NSSPKIXrevokedCertificates_InsertRevokedCertificate
  1215. (
  1216.   NSSPKIXrevokedCertificates *rcs,
  1217.   PRInt32 i,
  1218.   NSSPKIXrevokedCertificate *rc
  1219. );
  1220. /*
  1221.  * NSSPKIXrevokedCertificates_AppendRevokedCertificate
  1222.  *
  1223.  * -- fgmr comments --
  1224.  *
  1225.  * The error may be one of the following values:
  1226.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATES
  1227.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATE
  1228.  *  NSS_ERROR_NO_MEMORY
  1229.  *
  1230.  * Return value:
  1231.  *  PR_SUCCESS upon success
  1232.  *  PR_FAILURE upon failure
  1233.  */
  1234. NSS_EXTERN PRStatus
  1235. NSSPKIXrevokedCertificates_AppendRevokedCertificate
  1236. (
  1237.   NSSPKIXrevokedCertificates *rcs,
  1238.   PRInt32 i,
  1239.   NSSPKIXrevokedCertificate *rc
  1240. );
  1241. /*
  1242.  * NSSPKIXrevokedCertificates_RemoveRevokedCertificate
  1243.  *
  1244.  * -- fgmr comments --
  1245.  *
  1246.  * The error may be one of the following values:
  1247.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATES
  1248.  *  NSS_ERROR_VALUE_OUT_OF_RANGE
  1249.  *
  1250.  * Return value:
  1251.  *  PR_SUCCESS upon success
  1252.  *  PR_FAILURE upon failure
  1253.  */
  1254. NSS_EXTERN PRStatus
  1255. NSSPKIXrevokedCertificates_RemoveRevokedCertificate
  1256. (
  1257.   NSSPKIXrevokedCertificates *rcs,
  1258.   PRInt32 i
  1259. );
  1260. /*
  1261.  * NSSPKIXrevokedCertificates_FindRevokedCertificate
  1262.  *
  1263.  * -- fgmr comments --
  1264.  *
  1265.  * The error may be one of the following values:
  1266.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATES
  1267.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATE
  1268.  *
  1269.  * Return value:
  1270.  *  The index of the specified revoked certificate upon success
  1271.  *  -1 upon failure
  1272.  */
  1273. NSS_EXTERN PRInt32
  1274. NSSPKIXrevokedCertificates_FindRevokedCertificate
  1275. (
  1276.   NSSPKIXrevokedCertificates *rcs,
  1277.   NSSPKIXrevokedCertificate *rc
  1278. );
  1279. /*
  1280.  * NSSPKIXrevokedCertificates_Equal
  1281.  *
  1282.  * -- fgmr comments --
  1283.  *
  1284.  * The error may be one of the following values:
  1285.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATES
  1286.  *
  1287.  * Return value:
  1288.  *  PR_TRUE if the two objects have equal values
  1289.  *  PR_FALSE otherwise
  1290.  *  PR_FALSE upon error
  1291.  */
  1292. NSS_EXTERN PRBool
  1293. NSSPKIXrevokedCertificates_Equal
  1294. (
  1295.   NSSPKIXrevokedCertificates *one,
  1296.   NSSPKIXrevokedCertificates *two,
  1297.   PRStatus *statusOpt
  1298. );
  1299. /*
  1300.  * NSSPKIXrevokedCertificates_Duplicate
  1301.  *
  1302.  * -- fgmr comments --
  1303.  *
  1304.  * The error may be one of the following values:
  1305.  *  NSS_ERROR_INVALID_REVOKED_CERTIFICATES
  1306.  *  NSS_ERROR_INVALID_ARENA
  1307.  *  NSS_ERROR_NO_MEMORY
  1308.  *
  1309.  * Return value:
  1310.  *  A valid pointer to an NSSPKIXrevokedCertificates upon success
  1311.  *  NULL upon failure
  1312.  */
  1313. NSS_EXTERN NSSPKIXrevokedCertificates *
  1314. NSSPKIXrevokedCertificates_Duplicate
  1315. (
  1316.   NSSPKIXrevokedCertificates *rcs,
  1317.   NSSArena *arenaOpt
  1318. );
  1319. /*
  1320.  * revokedCertificate
  1321.  *
  1322.  * This is a "helper type" to simplify handling of TBSCertList objects.
  1323.  *
  1324.  *                                           SEQUENCE  {
  1325.  *            userCertificate         CertificateSerialNumber,
  1326.  *            revocationDate          Time,
  1327.  *            crlEntryExtensions      Extensions OPTIONAL
  1328.  *                                           -- if present, shall be v2
  1329.  *                                 }  OPTIONAL,
  1330.  *
  1331.  * The public calls for this type:
  1332.  *
  1333.  *  NSSPKIXrevokedCertificate_Decode
  1334.  *  NSSPKIXrevokedCertificate_Create
  1335.  *  NSSPKIXrevokedCertificate_Encode
  1336.  *  NSSPKIXrevokedCertificate_Destroy
  1337.  *  NSSPKIXrevokedCertificate_GetUserCertificate
  1338.  *  NSSPKIXrevokedCertificate_SetUserCertificate
  1339.  *  NSSPKIXrevokedCertificate_GetRevocationDate
  1340.  *  NSSPKIXrevokedCertificate_SetRevocationDate
  1341.  *  NSSPKIXrevokedCertificate_HasCrlEntryExtensions
  1342.  *  NSSPKIXrevokedCertificate_GetCrlEntryExtensions
  1343.  *  NSSPKIXrevokedCertificate_SetCrlEntryExtensions
  1344.  *  NSSPKIXrevokedCertificate_RemoveCrlEntryExtensions
  1345.  *  NSSPKIXrevokedCertificate_Equal
  1346.  *  NSSPKIXrevokedCertificate_Duplicate
  1347.  *
  1348.  */
  1349. /*
  1350.  * NSSPKIXrevokedCertificate_Decode
  1351.  *
  1352.  * -- fgmr comments --
  1353.  *
  1354.  * The error may be one of the following values:
  1355.  *  NSS_ERROR_INVALID_BER
  1356.  *  NSS_ERROR_NO_MEMORY
  1357.  *  NSS_ERROR_INVALID_ARENA
  1358.  *
  1359.  * Return value:
  1360.  *  A valid pointer to an NSSPKIXrevokedCertificate upon success
  1361.  *  NULL upon failure
  1362.  */
  1363. NSS_EXTERN NSSPKIXrevokedCertificate *
  1364. NSSPKIXrevokedCertificate_Decode
  1365. (
  1366.   NSSArena *arenaOpt,
  1367.   NSSBER *ber
  1368. );
  1369. /*
  1370.  * NSSPKIXrevokedCertificate_Create
  1371.  *
  1372.  * -- fgmr comments --
  1373.  *
  1374.  * The error may be one of the following values:
  1375.  *  NSS_ERROR_INVALID_ARENA
  1376.  *  NSS_ERROR_NO_MEMORY
  1377.  *  NSS_ERROR_INVALID_PKIX_CERTIFICATE_SERIAL_NUMBER
  1378.  *  NSS_ERROR_INVALID_PKIX_TIME
  1379.  *  NSS_ERROR_INVALID_PKIX_EXTENSIONS
  1380.  *
  1381.  * Return value:
  1382.  *  A valid pointer to an NSSPKIXrevokedCertificate upon success
  1383.  *  NULL upon failure
  1384.  */
  1385. NSS_EXTERN NSSPKIXrevokedCertificate *
  1386. NSSPKIXrevokedCertificate_Create
  1387. (
  1388.   NSSArena *arenaOpt,
  1389.   NSSPKIXCertificateSerialNumber *userCertificate,
  1390.   NSSPKIXTime *revocationDate,
  1391.   NSSPKIXExtensions *crlEntryExtensionsOpt
  1392. );
  1393. /*
  1394.  * NSSPKIXrevokedCertificate_Destroy
  1395.  *
  1396.  * -- fgmr comments --
  1397.  *
  1398.  * The error may be one of the following values:
  1399.  *  NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
  1400.  *
  1401.  * Return value:
  1402.  *  PR_SUCCESS upon success
  1403.  *  PR_FAILURE upon failure
  1404.  */
  1405. NSS_EXTERN PRStatus
  1406. NSSPKIXrevokedCertificate_Destroy
  1407. (
  1408.   NSSPKIXrevokedCertificate *rc
  1409. );
  1410. /*
  1411.  * NSSPKIXrevokedCertificate_Encode
  1412.  *
  1413.  * -- fgmr comments --
  1414.  *
  1415.  * The error may be one of the following values:
  1416.  *  NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
  1417.  *  NSS_ERROR_INVALID_ARENA
  1418.  *  NSS_ERROR_NO_MEMORY
  1419.  *
  1420.  * Return value:
  1421.  *  A valid NSSBER pointer upon success
  1422.  *  NULL upon failure
  1423.  */
  1424. NSS_EXTERN NSSBER *
  1425. NSSPKIXrevokedCertificate_Encode
  1426. (
  1427.   NSSPKIXrevokedCertificate *rc,
  1428.   NSSASN1EncodingType encoding,
  1429.   NSSBER *rvOpt,
  1430.   NSSArena *arenaOpt
  1431. );
  1432. /*
  1433.  * NSSPKIXrevokedCertificate_GetUserCertificate
  1434.  *
  1435.  * -- fgmr comments --
  1436.  *
  1437.  * The error may be one of the following values:
  1438.  *  NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
  1439.  *  NSS_ERROR_INVALID_ARENA
  1440.  *  NSS_ERROR_NO_MEMORY
  1441.  *
  1442.  * Return value:
  1443.  *  A valid pointer to an NSSPKIXCertificateSerialNumber upon success
  1444.  *  NULL upon failure
  1445.  */
  1446. NSS_EXTERN NSSPKIXCertificateSerialNumber *
  1447. NSSPKIXrevokedCertificate_GetUserCertificate
  1448. (
  1449.   NSSPKIXrevokedCertificate *rc,
  1450.   NSSArena *arenaOpt
  1451. );  
  1452. /*
  1453.  * NSSPKIXrevokedCertificate_SetUserCertificate
  1454.  *
  1455.  * -- fgmr comments --
  1456.  *
  1457.  * The error may be one of the following values:
  1458.  *  NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
  1459.  *  NSS_ERROR_NO_MEMORY
  1460.  *  NSS_ERROR_INVALID_PKIX_CERTIFICATE_SERIAL_NUMBER
  1461.  *
  1462.  * Return value:
  1463.  *  PR_SUCCESS upon success
  1464.  *  PR_FAILURE upon failure
  1465.  */
  1466. NSS_EXTERN PRStatus
  1467. NSSPKIXrevokedCertificate_SetUserCertificate
  1468. (
  1469.   NSSPKIXrevokedCertificate *rc,
  1470.   NSSPKIXCertificateSerialNumber *csn
  1471. );
  1472. /*
  1473.  * NSSPKIXrevokedCertificate_GetRevocationDate
  1474.  *
  1475.  * -- fgmr comments --
  1476.  *
  1477.  * The error may be one of the following values:
  1478.  *  NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
  1479.  *  NSS_ERROR_INVALID_ARENA
  1480.  *  NSS_ERROR_NO_MEMORY
  1481.  *
  1482.  * Return value:
  1483.  *  A valid pointer to an NSSPKIXTime upon success
  1484.  *  NULL upon failure
  1485.  */
  1486. NSS_EXTERN NSSPKIXTime *
  1487. NSSPKIXrevokedCertificate_GetRevocationDate
  1488. (
  1489.   NSSPKIXrevokedCertificate *rc,
  1490.   NSSArena *arenaOpt
  1491. );  
  1492. /*
  1493.  * NSSPKIXrevokedCertificate_SetRevocationDate
  1494.  *
  1495.  * -- fgmr comments --
  1496.  *
  1497.  * The error may be one of the following values:
  1498.  *  NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
  1499.  *  NSS_ERROR_NO_MEMORY
  1500.  *  NSS_ERROR_INVALID_PKIX_TIME
  1501.  *
  1502.  * Return value:
  1503.  *  PR_SUCCESS upon success
  1504.  *  PR_FAILURE upon failure
  1505.  */
  1506. NSS_EXTERN PRStatus
  1507. NSSPKIXrevokedCertificate_SetRevocationDate
  1508. (
  1509.   NSSPKIXrevokedCertificate *rc,
  1510.   NSSPKIXTime *revocationDate
  1511. );
  1512. /*
  1513.  * NSSPKIXrevokedCertificate_HasCrlEntryExtensions
  1514.  *
  1515.  * -- fgmr comments --
  1516.  *
  1517.  * The error may be one of the following values:
  1518.  *  NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
  1519.  *
  1520.  * Return value:
  1521.  *  PR_TRUE if it has one
  1522.  *  PR_FALSE if it doesn't
  1523.  *  PR_FALSE upon failure
  1524.  */
  1525. NSS_EXTERN PRBool
  1526. NSSPKIXrevokedCertificate_HasCrlEntryExtensions
  1527. (
  1528.   NSSPKIXrevokedCertificate *rc,
  1529.   PRStatus *statusOpt
  1530. );
  1531. /*
  1532.  * NSSPKIXrevokedCertificate_GetCrlEntryExtensions
  1533.  *
  1534.  * -- fgmr comments --
  1535.  *
  1536.  * The error may be one of the following values:
  1537.  *  NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
  1538.  *  NSS_ERROR_INVALID_ARENA
  1539.  *  NSS_ERROR_NO_MEMORY
  1540.  *  NSS_ERROR_NO_EXTENSIONS
  1541.  *
  1542.  * Return value:
  1543.  *  A valid pointer to an NSSPKIXExtensions upon success
  1544.  *  NULL upon failure
  1545.  */
  1546. NSS_EXTERN NSSPKIXExtensions *
  1547. NSSPKIXrevokedCertificate_GetCrlEntryExtensions
  1548. (
  1549.   NSSPKIXrevokedCertificate *rc,
  1550.   NSSArena *arenaOpt
  1551. );  
  1552. /*
  1553.  * NSSPKIXrevokedCertificate_SetCrlEntryExtensions
  1554.  *
  1555.  * -- fgmr comments --
  1556.  *
  1557.  * The error may be one of the following values:
  1558.  *  NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
  1559.  *  NSS_ERROR_NO_MEMORY
  1560.  *  NSS_ERROR_INVALID_PKIX_EXTENSIONS
  1561.  *
  1562.  * Return value:
  1563.  *  PR_SUCCESS upon success
  1564.  *  PR_FAILURE upon failure
  1565.  */
  1566. NSS_EXTERN PRStatus
  1567. NSSPKIXrevokedCertificate_SetCrlEntryExtensions
  1568. (
  1569.   NSSPKIXrevokedCertificate *rc,
  1570.   NSSPKIXExtensions *crlEntryExtensions
  1571. );
  1572. /*
  1573.  * NSSPKIXrevokedCertificate_RemoveCrlEntryExtensions
  1574.  *
  1575.  * -- fgmr comments --
  1576.  *
  1577.  * The error may be one of the following values:
  1578.  *  NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
  1579.  *  NSS_ERROR_NO_EXTENSIONS
  1580.  *
  1581.  * Return value:
  1582.  *  PR_SUCCESS upon success
  1583.  *  PR_FAILURE upon failure
  1584.  */
  1585. NSS_EXTERN PRStatus
  1586. NSSPKIXrevokedCertificate_RemoveCrlEntryExtensions
  1587. (
  1588.   NSSPKIXrevokedCertificate *rc
  1589. );
  1590. /*
  1591.  * NSSPKIXrevokedCertificate_Equal
  1592.  *
  1593.  * -- fgmr comments --
  1594.  *
  1595.  * The error may be one of the following values:
  1596.  *  NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
  1597.  *
  1598.  * Return value:
  1599.  *  PR_TRUE if the two objects have equal values
  1600.  *  PR_FALSE otherwise
  1601.  *  PR_FALSE upon error
  1602.  */
  1603. NSS_EXTERN PRBool
  1604. NSSPKIXrevokedCertificate_Equal
  1605. (
  1606.   NSSPKIXrevokedCertificate *one,
  1607.   NSSPKIXrevokedCertificate *two,
  1608.   PRStatus *statusOpt
  1609. );
  1610. /*
  1611.  * NSSPKIXrevokedCertificate_Duplicate
  1612.  *
  1613.  * -- fgmr comments --
  1614.  *
  1615.  * The error may be one of the following values:
  1616.  *  NSS_ERROR_INVALID_PKIX_REVOKED_CERTIFICATE
  1617.  *
  1618.  * Return value:
  1619.  *  A valid pointer to an NSSPKIXrevokedCertificate upon success
  1620.  *  NULL upon failure
  1621.  */
  1622. NSS_EXTERN NSSPKIXrevokedCertificate *
  1623. NSSPKIXrevokedCertificate_Duplicate
  1624. (
  1625.   NSSPKIXrevokedCertificate *rc,
  1626.   NSSArena *arenaOpt
  1627. );
  1628. /*
  1629.  * AlgorithmIdentifier
  1630.  *
  1631.  * -- fgmr comments --
  1632.  *
  1633.  * From RFC 2459:
  1634.  *
  1635.  * (1988 syntax)
  1636.  *
  1637.  *  AlgorithmIdentifier  ::=  SEQUENCE  {
  1638.  *       algorithm               OBJECT IDENTIFIER,
  1639.  *       parameters              ANY DEFINED BY algorithm OPTIONAL  }
  1640.  *                                  -- contains a value of the type
  1641.  *                                  -- registered for use with the
  1642.  *                                  -- algorithm object identifier value
  1643.  *
  1644.  * The public calls for this type:
  1645.  *
  1646.  *  NSSPKIXAlgorithmIdentifier_Decode
  1647.  *  NSSPKIXAlgorithmIdentifier_Create
  1648.  *  NSSPKIXAlgorithmIdentifier_Encode
  1649.  *  NSSPKIXAlgorithmIdentifier_Destroy
  1650.  *  NSSPKIXAlgorithmIdentifier_GetAlgorithm
  1651.  *  NSSPKIXAlgorithmIdentifier_SetAlgorithm
  1652.  *  NSSPKIXAlgorithmIdentifier_GetParameters
  1653.  *  NSSPKIXAlgorithmIdentifier_SetParameters
  1654.  *  NSSPKIXAlgorithmIdentifier_Compare
  1655.  *  NSSPKIXAlgorithmIdentifier_Duplicate
  1656.  *    { algorithm-specific parameter types and accessors ? }
  1657.  *
  1658.  */
  1659. /*
  1660.  * NSSPKIXAlgorithmIdentifier_Decode
  1661.  *
  1662.  * -- fgmr comments --
  1663.  *
  1664.  * The error may be one of the following values:
  1665.  *  NSS_ERROR_INVALID_BER
  1666.  *  NSS_ERROR_NO_MEMORY
  1667.  *  NSS_ERROR_INVALID_ARENA
  1668.  *
  1669.  * Return value:
  1670.  *  A valid pointer to an NSSPKIXAlgorithmIdentifier upon success
  1671.  *  NULL upon failure
  1672.  */
  1673. NSS_EXTERN NSSPKIXAlgorithmIdentifier *
  1674. NSSPKIXAlgorithmIdentifier_Decode
  1675. (
  1676.   NSSArena *arenaOpt,
  1677.   NSSBER *ber
  1678. );
  1679. /*
  1680.  * NSSPKIXAlgorithmIdentifier_Create
  1681.  *
  1682.  * -- fgmr comments --
  1683.  *
  1684.  * The error may be one of the following values:
  1685.  *  NSS_ERROR_NO_MEMORY
  1686.  *  NSS_ERROR_INVALID_ARENA
  1687.  *  NSS_ERROR_INVALID_OID
  1688.  *  NSS_ERROR_INVALID_POINTER
  1689.  *
  1690.  * Return value:
  1691.  *  A valid pointer to an NSSPKIXAlgorithmIdentifier upon success
  1692.  *  NULL upon failure
  1693.  */
  1694. NSS_EXTERN NSSPKIXAlgorithmIdentifier *
  1695. NSSPKIXAlgorithmIdentifier_Create
  1696. (
  1697.   NSSArena *arenaOpt,
  1698.   NSSOID *algorithm,
  1699.   NSSItem *parameters
  1700. );
  1701. /*
  1702.  * NSSPKIXAlgorithmIdentifier_Destroy
  1703.  *
  1704.  * -- fgmr comments --
  1705.  *
  1706.  * The error may be one of the following values:
  1707.  *  NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
  1708.  *
  1709.  * Return value:
  1710.  *  PR_SUCCESS upon success
  1711.  *  PR_FAILURE upon failure
  1712.  */
  1713. NSS_EXTERN PRStatus
  1714. NSSPKIXAlgorithmIdentifier_Destroy
  1715. (
  1716.   NSSPKIXAlgorithmIdentifier *algid
  1717. );
  1718. /*
  1719.  * NSSPKIXAlgorithmIdentifier_Encode
  1720.  *
  1721.  * -- fgmr comments --
  1722.  *
  1723.  * The error may be one of the following values:
  1724.  *  NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
  1725.  *  NSS_ERROR_INVALID_ARENA
  1726.  *  NSS_ERROR_NO_MEMORY
  1727.  *
  1728.  * Return value:
  1729.  *  A valid NSSBER pointer upon success
  1730.  *  NULL upon failure
  1731.  */
  1732. NSS_EXTERN NSSBER *
  1733. NSSPKIXAlgorithmIdentifier_Encode
  1734. (
  1735.   NSSPKIXAlgorithmIdentifier *algid,
  1736.   NSSASN1EncodingType encoding,
  1737.   NSSBER *rvOpt,
  1738.   NSSArena *arenaOpt
  1739. );
  1740. /*
  1741.  * NSSPKIXAlgorithmIdentifier_GetAlgorithm
  1742.  *
  1743.  * -- fgmr comments --
  1744.  *
  1745.  * The error may be one of the following values:
  1746.  *  NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
  1747.  *  NSS_ERROR_NO_MEMORY
  1748.  *
  1749.  * Return value:
  1750.  *  A valid NSSOID pointer upon success
  1751.  *  NULL upon failure
  1752.  */
  1753. NSS_EXTERN NSSOID *
  1754. NSSPKIXAlgorithmIdentifier_GetAlgorithm
  1755. (
  1756.   NSSPKIXAlgorithmIdentifier *algid
  1757. );
  1758. /*
  1759.  * NSSPKIXAlgorithmIdentifier_SetAlgorithm
  1760.  *
  1761.  * -- fgmr comments --
  1762.  *
  1763.  * The error may be one of the following values:
  1764.  *  NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
  1765.  *  NSS_ERROR_INVALID_OID
  1766.  *
  1767.  * Return value:
  1768.  *  PR_SUCCESS upon success
  1769.  *  PR_FAILURE upon failure
  1770.  */
  1771. NSS_EXTERN PRStatus
  1772. NSSPKIXAlgorithmIdentifier_SetAlgorithm
  1773. (
  1774.   NSSPKIXAlgorithmIdentifier *algid,
  1775.   NSSOID *algorithm
  1776. );
  1777. /*
  1778.  * NSSPKIXAlgorithmIdentifier_GetParameters
  1779.  *
  1780.  * -- fgmr comments --
  1781.  *
  1782.  * The error may be one of the following values:
  1783.  *  NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
  1784.  *  NSS_ERROR_INVALID_ARENA
  1785.  *  NSS_ERROR_NO_MEMORY
  1786.  *
  1787.  * Return value:
  1788.  *  A valid pointer to an NSSItem upon success
  1789.  *  NULL upon failure
  1790.  */
  1791. NSS_EXTERN NSSItem *
  1792. NSSPKIXAlgorithmIdentifier_GetParameters
  1793. (
  1794.   NSSPKIXAlgorithmIdentifier *algid,
  1795.   NSSItem *rvOpt,
  1796.   NSSArena *arenaOpt
  1797. );
  1798. /*
  1799.  * NSSPKIXAlgorithmIdentifier_SetParameters
  1800.  *
  1801.  * -- fgmr comments --
  1802.  *
  1803.  * The error may be one of the following values:
  1804.  *  NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
  1805.  *  NSS_ERROR_INVALID_POINTER
  1806.  *  NSS_ERROR_NO_MEMORY
  1807.  *
  1808.  * Return value:
  1809.  *  PR_SUCCESS upon success
  1810.  *  PR_FAILURE upon failure
  1811.  */
  1812. NSS_EXTERN PRStatus
  1813. NSSPKIXAlgorithmIdentifier_SetParameters
  1814. (
  1815.   NSSPKIXAlgorithmIdentifier *algid,
  1816.   NSSItem *parameters
  1817. );
  1818. /*
  1819.  * NSSPKIXAlgorithmIdentifier_Equal
  1820.  *
  1821.  * -- fgmr comments --
  1822.  *
  1823.  * The error may be one of the following values:
  1824.  *  NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
  1825.  *
  1826.  * Return value:
  1827.  *  PR_TRUE if the two objects have equal values
  1828.  *  PR_FALSE otherwise
  1829.  *  PR_FALSE upon error
  1830.  */
  1831. NSS_EXTERN PRBool
  1832. NSSPKIXAlgorithmIdentifier_Equal
  1833. (
  1834.   NSSPKIXAlgorithmIdentifier *algid1,
  1835.   NSSPKIXAlgorithmIdentifier *algid2,
  1836.   PRStatus *statusOpt
  1837. );
  1838. /*
  1839.  * NSSPKIXAlgorithmIdentifier_Duplicate
  1840.  *
  1841.  * -- fgmr comments --
  1842.  *
  1843.  * The error may be one of the following values:
  1844.  *  NSS_ERROR_INVALID_PKIX_ALGORITHM_IDENTIFIER
  1845.  *  NSS_ERROR_INVALID_ARENA
  1846.  *  NSS_ERROR_NO_MEMORY
  1847.  *
  1848.  * Return value:
  1849.  *  A valid pointer to an NSSPKIXAlgorithmIdentifier upon success
  1850.  *  NULL upon failure
  1851.  */
  1852. NSS_EXTERN NSSPKIXAlgorithmIdentifier *
  1853. NSSPKIXAlgorithmIdentifier_Duplicate
  1854. (
  1855.   NSSPKIXAlgorithmIdentifier *algid,
  1856.   NSSArena *arenaOpt
  1857. );
  1858. /*
  1859.  *   { algorithm-specific parameter types and accessors ? }
  1860.  */
  1861. /*
  1862.  * ORAddress
  1863.  *
  1864.  * -- fgmr comments --
  1865.  *
  1866.  * From RFC 2459:
  1867.  *
  1868.  *  ORAddress ::= SEQUENCE {
  1869.  *     built-in-standard-attributes BuiltInStandardAttributes,
  1870.  *     built-in-domain-defined-attributes
  1871.  *                          BuiltInDomainDefinedAttributes OPTIONAL,
  1872.  *     -- see also teletex-domain-defined-attributes
  1873.  *     extension-attributes ExtensionAttributes OPTIONAL }
  1874.  *  --      The OR-address is semantically absent from the OR-name if the
  1875.  *  --      built-in-standard-attribute sequence is empty and the
  1876.  *  --      built-in-domain-defined-attributes and extension-attributes are
  1877.  *  --      both omitted.
  1878.  *
  1879.  * The public calls for this type:
  1880.  *
  1881.  *  NSSPKIXORAddress_Decode
  1882.  *  NSSPKIXORAddress_Create
  1883.  *  NSSPKIXORAddress_Destroy
  1884.  *  NSSPKIXORAddress_Encode
  1885.  *  NSSPKIXORAddress_GetBuiltInStandardAttributes
  1886.  *  NSSPKIXORAddress_SetBuiltInStandardAttributes
  1887.  *  NSSPKIXORAddress_HasBuiltInDomainDefinedAttributes
  1888.  *  NSSPKIXORAddress_GetBuiltInDomainDefinedAttributes
  1889.  *  NSSPKIXORAddress_SetBuiltInDomainDefinedAttributes
  1890.  *  NSSPKIXORAddress_RemoveBuiltInDomainDefinedAttributes
  1891.  *  NSSPKIXORAddress_HasExtensionsAttributes
  1892.  *  NSSPKIXORAddress_GetExtensionsAttributes
  1893.  *  NSSPKIXORAddress_SetExtensionsAttributes
  1894.  *  NSSPKIXORAddress_RemoveExtensionsAttributes
  1895.  *  NSSPKIXORAddress_Equal
  1896.  *  NSSPKIXORAddress_Duplicate
  1897.  *
  1898.  */
  1899. /*
  1900.  * NSSPKIXORAddress_Decode
  1901.  *
  1902.  * -- fgmr comments --
  1903.  *
  1904.  * The error may be one of the following values:
  1905.  *  NSS_ERROR_INVALID_BER
  1906.  *  NSS_ERROR_NO_MEMORY
  1907.  *  NSS_ERROR_INVALID_ARENA
  1908.  *
  1909.  * Return value:
  1910.  *  A valid pointer to an NSSPKIXORAddres upon success
  1911.  *  NULL upon failure
  1912.  */
  1913. NSS_EXTERN NSSPKIXORAddress *
  1914. NSSPKIXORAddress_Decode
  1915. (
  1916.   NSSArena *arenaOpt,
  1917.   NSSBER *ber
  1918. );
  1919. /*
  1920.  * NSSPKIXORAddress_Create
  1921.  *
  1922.  * -- fgmr comments --
  1923.  *
  1924.  * The error may be one of the following values:
  1925.  *  NSS_ERROR_NO_MEMORY
  1926.  *  NSS_ERROR_INVALID_ARENA
  1927.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  1928.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
  1929.  *  NSS_ERROR_INVALID_PKIX_EXTENSIONS_ATTRIBUTES
  1930.  *
  1931.  * Return value:
  1932.  *  A valid pointer to an NSSPKIXORAddres upon success
  1933.  *  NULL upon failure
  1934.  */
  1935. NSS_EXTERN NSSPKIXORAddress *
  1936. NSSPKIXORAddress_Create
  1937. (
  1938.   NSSArena *arenaOpt,
  1939.   NSSPKIXBuiltInStandardAttributes *bisa,
  1940.   NSSPKIXBuiltInDomainDefinedAttributes *biddaOpt,
  1941.   NSSPKIXExtensionAttributes *eaOpt
  1942. );
  1943. /*
  1944.  * NSSPKIXORAddress_Destroy
  1945.  *
  1946.  * -- fgmr comments --
  1947.  *
  1948.  * The error may be one of the following values:
  1949.  *  NSS_ERROR_INVALID_PKIX_OR_ADDRESS
  1950.  *
  1951.  * Return value:
  1952.  *  PR_SUCCESS upon success
  1953.  *  PR_FAILURE upon failure
  1954.  */
  1955. NSS_EXTERN PRStatus
  1956. NSSPKIXORAddress_Destroy
  1957. (
  1958.   NSSPKIXORAddress *ora
  1959. );
  1960. /*
  1961.  * NSSPKIXORAddress_Encode
  1962.  *
  1963.  * -- fgmr comments --
  1964.  *
  1965.  * The error may be one of the following values:
  1966.  *  NSS_ERROR_INVALID_PKIX_OR_ADDRESS
  1967.  *  NSS_ERROR_INVALID_ARENA
  1968.  *  NSS_ERROR_NO_MEMORY
  1969.  *
  1970.  * Return value:
  1971.  *  A valid NSSBER pointer upon success
  1972.  *  NULL upon failure
  1973.  */
  1974. NSS_EXTERN NSSBER *
  1975. NSSPKIXORAddress_Encode
  1976. (
  1977.   NSSPKIXORAddress *ora,
  1978.   NSSASN1EncodingType encoding,
  1979.   NSSBER *rvOpt,
  1980.   NSSArena *arenaOpt
  1981. );
  1982. /*
  1983.  * NSSPKIXORAddress_GetBuiltInStandardAttributes
  1984.  *
  1985.  * -- fgmr comments --
  1986.  *
  1987.  * The error may be one of the following values:
  1988.  *  NSS_ERROR_INVALID_PKIX_OR_ADDRESS
  1989.  *  NSS_ERROR_INVALID_ARENA
  1990.  *  NSS_ERROR_NO_MEMORY
  1991.  *
  1992.  * Return value:
  1993.  *  A valid pointer to an NSSPKIXBuiltInStandardAttributes upon success
  1994.  *  NULL upon failure
  1995.  */
  1996. NSS_EXTERN NSSPKIXBuiltInStandardAttributes *
  1997. NSSPKIXORAddress_GetBuiltInStandardAttributes
  1998. (
  1999.   NSSPKIXORAddress *ora,
  2000.   NSSArena *arenaOpt
  2001. );
  2002. /*
  2003.  * NSSPKIXORAddress_SetBuiltInStandardAttributes
  2004.  *
  2005.  * -- fgmr comments --
  2006.  *
  2007.  * The error may be one of the following values:
  2008.  *  NSS_ERROR_INVALID_PKIX_OR_ADDRESS
  2009.  *  NSS_ERROR_NO_MEMORY
  2010.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2011.  *
  2012.  * Return value:
  2013.  *  PR_SUCCESS upon success
  2014.  *  PR_FAILURE upon failure
  2015.  */
  2016. NSS_EXTERN PRStatus
  2017. NSSPKIXORAddress_SetBuiltInStandardAttributes
  2018. (
  2019.   NSSPKIXORAddress *ora,
  2020.   NSSPKIXBuiltInStandardAttributes *bisa
  2021. );
  2022. /*
  2023.  * NSSPKIXORAddress_HasBuiltInDomainDefinedAttributes
  2024.  *
  2025.  * -- fgmr comments --
  2026.  *
  2027.  * The error may be one of the following values:
  2028.  *  NSS_ERROR_INVALID_PKIX_OR_ADDRESS
  2029.  *
  2030.  * Return value:
  2031.  *  PR_TRUE if it has one
  2032.  *  PR_FALSE if it doesn't
  2033.  *  PR_FALSE upon failure
  2034.  */
  2035. NSS_EXTERN PRBool
  2036. NSSPKIXORAddress_HasBuiltInDomainDefinedAttributes
  2037. (
  2038.   NSSPKIXORAddress *ora,
  2039.   PRStatus *statusOpt
  2040. );
  2041. /*
  2042.  * NSSPKIXORAddress_GetBuiltInDomainDefinedAttributes
  2043.  *
  2044.  * -- fgmr comments --
  2045.  *
  2046.  * The error may be one of the following values:
  2047.  *  NSS_ERROR_INVALID_PKIX_OR_ADDRESS
  2048.  *  NSS_ERROR_INVALID_ARENA
  2049.  *  NSS_ERROR_NO_MEMORY
  2050.  *  NSS_ERROR_NO_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
  2051.  *
  2052.  * Return value:
  2053.  *  A valid pointer to an NSSPKIXBuiltInDomainDefinedAttributes upon
  2054.  *      success
  2055.  *  NULL upon failure
  2056.  */
  2057. NSS_EXTERN NSSPKIXBuiltInDomainDefinedAttributes *
  2058. NSSPKIXORAddress_GetBuiltInDomainDefinedAttributes
  2059. (
  2060.   NSSPKIXORAddress *ora,
  2061.   NSSArena *arenaOpt
  2062. );
  2063. /*
  2064.  * NSSPKIXORAddress_SetBuiltInDomainDefinedAttributes
  2065.  *
  2066.  * -- fgmr comments --
  2067.  *
  2068.  * The error may be one of the following values:
  2069.  *  NSS_ERROR_INVALID_PKIX_OR_ADDRESS
  2070.  *  NSS_ERROR_NO_MEMORY
  2071.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
  2072.  *
  2073.  * Return value:
  2074.  *  PR_SUCCESS upon success
  2075.  *  PR_FAILURE upon failure
  2076.  */
  2077. NSS_EXTERN PRStatus
  2078. NSSPKIXORAddress_SetBuiltInDomainDefinedAttributes
  2079. (
  2080.   NSSPKIXORAddress *ora,
  2081.   NSSPKIXBuiltInStandardAttributes *bisa
  2082. );
  2083. /*
  2084.  * NSSPKIXORAddress_RemoveBuiltInDomainDefinedAttributes
  2085.  *
  2086.  * -- fgmr comments --
  2087.  *
  2088.  * The error may be one of the following values:
  2089.  *  NSS_ERROR_INVALID_PKIX_OR_ADDRESS
  2090.  *  NSS_ERROR_NO_BUILT_IN_DOMAIN_DEFINED_ATTRIBUTES
  2091.  *
  2092.  * Return value:
  2093.  *  PR_SUCCESS upon success
  2094.  *  PR_FAILURE upon failure
  2095.  */
  2096. NSS_EXTERN PRStatus
  2097. NSSPKIXORAddress_RemoveBuiltInDomainDefinedAttributes
  2098. (
  2099.   NSSPKIXORAddress *ora
  2100. );
  2101. /*
  2102.  * NSSPKIXORAddress_HasExtensionsAttributes
  2103.  *
  2104.  * -- fgmr comments --
  2105.  *
  2106.  * The error may be one of the following values:
  2107.  *  NSS_ERROR_INVALID_PKIX_OR_ADDRESS
  2108.  *
  2109.  * Return value:
  2110.  *  PR_TRUE if it has one
  2111.  *  PR_FALSE if it doesn't
  2112.  *  PR_FALSE upon failure
  2113.  */
  2114. NSS_EXTERN PRBool
  2115. NSSPKIXORAddress_HasExtensionsAttributes
  2116. (
  2117.   NSSPKIXORAddress *ora,
  2118.   PRStatus *statusOpt
  2119. );
  2120. /*
  2121.  * NSSPKIXORAddress_GetExtensionsAttributes
  2122.  *
  2123.  * -- fgmr comments --
  2124.  *
  2125.  * The error may be one of the following values:
  2126.  *  NSS_ERROR_INVALID_PKIX_OR_ADDRESS
  2127.  *  NSS_ERROR_INVALID_ARENA
  2128.  *  NSS_ERROR_NO_MEMORY
  2129.  *  NSS_ERROR_NO_EXTENSION_ATTRIBUTES
  2130.  *
  2131.  * Return value:
  2132.  *  A valid pointer to an NSSPKIXExtensionAttributes upon success
  2133.  *  NULL upon failure
  2134.  */
  2135. NSS_EXTERN NSSPKIXExtensionAttributes *
  2136. NSSPKIXORAddress_GetExtensionsAttributes
  2137. (
  2138.   NSSPKIXORAddress *ora,
  2139.   NSSArena *arenaOpt
  2140. );
  2141. /*
  2142.  * NSSPKIXORAddress_SetExtensionsAttributes
  2143.  *
  2144.  * -- fgmr comments --
  2145.  *
  2146.  * The error may be one of the following values:
  2147.  *  NSS_ERROR_INVALID_PKIX_OR_ADDRESS
  2148.  *  NSS_ERROR_NO_MEMORY
  2149.  *  NSS_ERROR_INVALID_PKIX_EXTENSION_ATTRIBUTES
  2150.  *
  2151.  * Return value:
  2152.  *  PR_SUCCESS upon success
  2153.  *  PR_FAILURE upon failure
  2154.  */
  2155. NSS_EXTERN PRStatus
  2156. NSSPKIXORAddress_SetExtensionsAttributes
  2157. (
  2158.   NSSPKIXORAddress *ora,
  2159.   NSSPKIXExtensionAttributes *eaOpt
  2160. );
  2161. /*
  2162.  * NSSPKIXORAddress_RemoveExtensionsAttributes
  2163.  *
  2164.  * -- fgmr comments --
  2165.  *
  2166.  * The error may be one of the following values:
  2167.  *  NSS_ERROR_INVALID_PKIX_OR_ADDRESS
  2168.  *  NSS_ERROR_NO_EXTENSION_ATTRIBUTES
  2169.  *
  2170.  * Return value:
  2171.  *  PR_SUCCESS upon success
  2172.  *  PR_FAILURE upon failure
  2173.  */
  2174. NSS_EXTERN PRStatus
  2175. NSSPKIXORAddress_RemoveExtensionsAttributes
  2176. (
  2177.   NSSPKIXORAddress *ora
  2178. );
  2179. /*
  2180.  * NSSPKIXORAddress_Equal
  2181.  *
  2182.  * -- fgmr comments --
  2183.  *
  2184.  * The error may be one of the following values:
  2185.  *  NSS_ERROR_INVALID_PKIX_OR_ADDRESS
  2186.  *
  2187.  * Return value:
  2188.  *  PR_TRUE if the two objects have equal values
  2189.  *  PR_FALSE otherwise
  2190.  *  PR_FALSE upon error
  2191.  */
  2192. NSS_EXTERN PRBool
  2193. NSSPKIXORAddress_Equal
  2194. (
  2195.   NSSPKIXORAddress *ora1,
  2196.   NSSPKIXORAddress *ora2,
  2197.   PRStatus *statusOpt
  2198. );
  2199. /*
  2200.  * NSSPKIXORAddress_Duplicate
  2201.  *
  2202.  * -- fgmr comments --
  2203.  *
  2204.  * The error may be one of the following values:
  2205.  *  NSS_ERROR_INVALID_PKIX_OR_ADDRESS
  2206.  *  NSS_ERROR_INVALID_ARENA
  2207.  *  NSS_ERROR_NO_MEMORY
  2208.  *
  2209.  * Return value:
  2210.  *  A valid pointer to an NSSPKIXORAddres upon success
  2211.  *  NULL upon failure
  2212.  */
  2213. NSS_EXTERN NSSPKIXORAddress *
  2214. NSSPKIXORAddress_Duplicate
  2215. (
  2216.   NSSPKIXORAddress *ora,
  2217.   NSSArena *arenaOpt
  2218. );
  2219. /*
  2220.  * BuiltInStandardAttributes
  2221.  *
  2222.  * -- fgmr comments --
  2223.  *
  2224.  * From RFC 2459:
  2225.  *
  2226.  *  BuiltInStandardAttributes ::= SEQUENCE {
  2227.  *     country-name CountryName OPTIONAL,
  2228.  *     administration-domain-name AdministrationDomainName OPTIONAL,
  2229.  *     network-address      [0] NetworkAddress OPTIONAL,
  2230.  *     -- see also extended-network-address
  2231.  *     terminal-identifier  [1] TerminalIdentifier OPTIONAL,
  2232.  *     private-domain-name  [2] PrivateDomainName OPTIONAL,
  2233.  *     organization-name    [3] OrganizationName OPTIONAL,
  2234.  *     -- see also teletex-organization-name
  2235.  *     numeric-user-identifier      [4] NumericUserIdentifier OPTIONAL,
  2236.  *     personal-name        [5] PersonalName OPTIONAL,
  2237.  *     -- see also teletex-personal-name
  2238.  *     organizational-unit-names    [6] OrganizationalUnitNames OPTIONAL
  2239.  *     -- see also teletex-organizational-unit-names -- }
  2240.  *
  2241.  * The public calls for this type:
  2242.  *
  2243.  *  NSSPKIXBuiltInStandardAttributes_Decode
  2244.  *  NSSPKIXBuiltInStandardAttributes_Create
  2245.  *  NSSPKIXBuiltInStandardAttributes_Destroy
  2246.  *  NSSPKIXBuiltInStandardAttributes_Encode
  2247.  *  NSSPKIXBuiltInStandardAttributes_HasCountryName
  2248.  *  NSSPKIXBuiltInStandardAttributes_GetCountryName
  2249.  *  NSSPKIXBuiltInStandardAttributes_SetCountryName
  2250.  *  NSSPKIXBuiltInStandardAttributes_RemoveCountryName
  2251.  *  NSSPKIXBuiltInStandardAttributes_HasAdministrationDomainName
  2252.  *  NSSPKIXBuiltInStandardAttributes_GetAdministrationDomainName
  2253.  *  NSSPKIXBuiltInStandardAttributes_SetAdministrationDomainName
  2254.  *  NSSPKIXBuiltInStandardAttributes_RemoveAdministrationDomainName
  2255.  *  NSSPKIXBuiltInStandardAttributes_HasNetworkAddress
  2256.  *  NSSPKIXBuiltInStandardAttributes_GetNetworkAddress
  2257.  *  NSSPKIXBuiltInStandardAttributes_SetNetworkAddress
  2258.  *  NSSPKIXBuiltInStandardAttributes_RemoveNetworkAddress
  2259.  *  NSSPKIXBuiltInStandardAttributes_HasTerminalIdentifier
  2260.  *  NSSPKIXBuiltInStandardAttributes_GetTerminalIdentifier
  2261.  *  NSSPKIXBuiltInStandardAttributes_SetTerminalIdentifier
  2262.  *  NSSPKIXBuiltInStandardAttributes_RemoveTerminalIdentifier
  2263.  *  NSSPKIXBuiltInStandardAttributes_HasPrivateDomainName
  2264.  *  NSSPKIXBuiltInStandardAttributes_GetPrivateDomainName
  2265.  *  NSSPKIXBuiltInStandardAttributes_SetPrivateDomainName
  2266.  *  NSSPKIXBuiltInStandardAttributes_RemovePrivateDomainName
  2267.  *  NSSPKIXBuiltInStandardAttributes_HasOrganizationName
  2268.  *  NSSPKIXBuiltInStandardAttributes_GetOrganizationName
  2269.  *  NSSPKIXBuiltInStandardAttributes_SetOrganizationName
  2270.  *  NSSPKIXBuiltInStandardAttributes_RemoveOrganizationName
  2271.  *  NSSPKIXBuiltInStandardAttributes_HasNumericUserIdentifier
  2272.  *  NSSPKIXBuiltInStandardAttributes_GetNumericUserIdentifier
  2273.  *  NSSPKIXBuiltInStandardAttributes_SetNumericUserIdentifier
  2274.  *  NSSPKIXBuiltInStandardAttributes_RemoveNumericUserIdentifier
  2275.  *  NSSPKIXBuiltInStandardAttributes_HasPersonalName
  2276.  *  NSSPKIXBuiltInStandardAttributes_GetPersonalName
  2277.  *  NSSPKIXBuiltInStandardAttributes_SetPersonalName
  2278.  *  NSSPKIXBuiltInStandardAttributes_RemovePersonalName
  2279.  *  NSSPKIXBuiltInStandardAttributes_HasOrganizationLUnitNames
  2280.  *  NSSPKIXBuiltInStandardAttributes_GetOrganizationLUnitNames
  2281.  *  NSSPKIXBuiltInStandardAttributes_SetOrganizationLUnitNames
  2282.  *  NSSPKIXBuiltInStandardAttributes_RemoveOrganizationLUnitNames
  2283.  *  NSSPKIXBuiltInStandardAttributes_Equal
  2284.  *  NSSPKIXBuiltInStandardAttributes_Duplicate
  2285.  *
  2286.  */
  2287. /*
  2288.  * NSSPKIXBuiltInStandardAttributes_Decode
  2289.  *
  2290.  * -- fgmr comments --
  2291.  *
  2292.  * The error may be one of the following values:
  2293.  *  NSS_ERROR_INVALID_BER
  2294.  *  NSS_ERROR_NO_MEMORY
  2295.  *  NSS_ERROR_INVALID_ARENA
  2296.  *
  2297.  * Return value:
  2298.  *  A valid pointer to an NSSPKIXBuiltInStandardAttributes upon success
  2299.  *  NULL upon failure
  2300.  */
  2301. NSS_EXTERN NSSPKIXBuiltInStandardAttributes *
  2302. NSSPKIXBuiltInStandardAttributes_Decode
  2303. (
  2304.   NSSArena *arenaOpt,
  2305.   NSSBER *ber
  2306. );
  2307. /*
  2308.  * NSSPKIXBuiltInStandardAttributes_Create
  2309.  *
  2310.  * -- fgmr comments --
  2311.  *
  2312.  * The error may be one of the following values:
  2313.  *  NSS_ERROR_NO_MEMORY
  2314.  *  NSS_ERROR_INVALID_ARENA
  2315.  *  NSS_ERROR_INVALID_PKIX_COUNTRY_NAME
  2316.  *  NSS_ERROR_INVALID_PKIX_ADMINISTRATION_DOMAIN_NAME
  2317.  *  NSS_ERROR_INVALID_PKIX_NETWORK_ADDRESS
  2318.  *  NSS_ERROR_INVALID_PKIX_TERMINAL_IDENTIFIER
  2319.  *  NSS_ERROR_INVALID_PKIX_PRIVATE_DOMAIN_NAME
  2320.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATION_NAME
  2321.  *  NSS_ERROR_INVALID_PKIX_NUMERIC_USER_IDENTIFIER
  2322.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  2323.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
  2324.  *
  2325.  * Return value:
  2326.  *  A valid pointer to an NSSPKIXBuiltInStandardAttributes upon success
  2327.  *  NULL upon failure
  2328.  */
  2329. NSS_EXTERN NSSPKIXBuiltInStandardAttributes *
  2330. NSSPKIXBuiltInStandardAttributes_Create
  2331. (
  2332.   NSSArena *arenaOpt,
  2333.   NSSPKIXCountryName *countryNameOpt,
  2334.   NSSPKIXAdministrationDomainName *administrationDomainNameOpt,
  2335.   NSSPKIXNetworkAddress *networkAddressOpt,
  2336.   NSSPKIXTerminalIdentifier *terminalIdentifierOpt,
  2337.   NSSPKIXPrivateDomainName *privateDomainNameOpt,
  2338.   NSSPKIXOrganizationName *organizationNameOpt,
  2339.   NSSPKIXNumericUserIdentifier *numericUserIdentifierOpt,
  2340.   NSSPKIXPersonalName *personalNameOpt,
  2341.   NSSPKIXOrganizationalUnitNames *organizationalUnitNamesOpt
  2342. );
  2343. /*
  2344.  * NSSPKIXBuiltInStandardAttributes_Destroy
  2345.  *
  2346.  * -- fgmr comments --
  2347.  *
  2348.  * The error may be one of the following values:
  2349.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2350.  *
  2351.  * Return value:
  2352.  *  PR_SUCCESS upon success
  2353.  *  PR_FAILURE upon failure
  2354.  */
  2355. NSS_EXTERN PRStatus
  2356. NSSPKIXBuiltInStandardAttributes_Destroy
  2357. (
  2358.   NSSPKIXBuiltInStandardAttributes *bisa
  2359. );
  2360. /*
  2361.  * NSSPKIXBuiltInStandardAttributes_Encode
  2362.  *
  2363.  * -- fgmr comments --
  2364.  *
  2365.  * The error may be one of the following values:
  2366.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2367.  *  NSS_ERROR_NO_MEMORY
  2368.  *  NSS_ERROR_INVALID_ARENA
  2369.  *
  2370.  * Return value:
  2371.  *  A valid NSSBER pointer upon success
  2372.  *  NULL upon failure
  2373.  */
  2374. NSS_EXTERN NSSBER *
  2375. NSSPKIXBuiltInStandardAttributes_Encode
  2376. (
  2377.   NSSPKIXBuiltInStandardAttributes *bisa,
  2378.   NSSASN1EncodingType encoding,
  2379.   NSSBER *rvOpt,
  2380.   NSSArena *arenaOpt
  2381. );
  2382. /*
  2383.  * NSSPKIXBuiltInStandardAttributes_HasCountryName
  2384.  *
  2385.  * -- fgmr comments --
  2386.  *
  2387.  * The error may be one of the following values:
  2388.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2389.  *
  2390.  * Return value:
  2391.  *  PR_TRUE if it has one
  2392.  *  PR_FALSE if it doesn't
  2393.  *  PR_FALSE upon failure
  2394.  */
  2395. NSS_EXTERN PRBool
  2396. NSSPKIXBuiltInStandardAttributes_HasCountryName
  2397. (
  2398.   NSSPKIXBuiltInStandardAttributes *bisa,
  2399.   PRStatus *statusOpt
  2400. );
  2401. /*
  2402.  * NSSPKIXBuiltInStandardAttributes_GetCountryName
  2403.  *
  2404.  * -- fgmr comments --
  2405.  *
  2406.  * The error may be one of the following values:
  2407.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2408.  *  NSS_ERROR_NO_MEMORY
  2409.  *  NSS_ERROR_INVALID_ARENA
  2410.  *
  2411.  * Return value:
  2412.  *  A valid pointer to an NSSPKIXCountryName upon success
  2413.  *  NULL upon failure
  2414.  */
  2415. NSS_EXTERN NSSPKIXCountryName *
  2416. NSSPKIXBuiltInStandardAttributes_GetCountryName
  2417. (
  2418.   NSSPKIXBuiltInStandardAttributes *bisa,
  2419.   NSSArena *arenaOpt
  2420. );
  2421. /*
  2422.  * NSSPKIXBuiltInStandardAttributes_SetCountryName
  2423.  *
  2424.  * -- fgmr comments --
  2425.  *
  2426.  * The error may be one of the following values:
  2427.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2428.  *  NSS_ERROR_NO_MEMORY
  2429.  *  NSS_ERROR_INVALID_PKIX_COUNTRY_NAME
  2430.  *
  2431.  * Return value:
  2432.  *  PR_SUCCESS upon success
  2433.  *  PR_FAILURE upon failure
  2434.  */
  2435. NSS_EXTERN PRStatus
  2436. NSSPKIXBuiltInStandardAttributes_SetCountryName
  2437. (
  2438.   NSSPKIXBuiltInStandardAttributes *bisa,
  2439.   NSSPKIXCountryName *countryName
  2440. );
  2441. /*
  2442.  * NSSPKIXBuiltInStandardAttributes_RemoveCountryName
  2443.  *
  2444.  * -- fgmr comments --
  2445.  *
  2446.  * The error may be one of the following values:
  2447.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2448.  *  NSS_ERROR_NO_COUNTRY_NAME
  2449.  *
  2450.  * Return value:
  2451.  *  PR_SUCCESS upon success
  2452.  *  PR_FAILURE upon failure
  2453.  */
  2454. NSS_EXTERN PRStatus
  2455. NSSPKIXBuiltInStandardAttributes_RemoveCountryName
  2456. (
  2457.   NSSPKIXBuiltInStandardAttributes *bisa
  2458. );
  2459. /*
  2460.  * NSSPKIXBuiltInStandardAttributes_HasAdministrationDomainName
  2461.  *
  2462.  * -- fgmr comments --
  2463.  *
  2464.  * The error may be one of the following values:
  2465.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2466.  *
  2467.  * Return value:
  2468.  *  PR_TRUE if it has one
  2469.  *  PR_FALSE if it doesn't
  2470.  *  PR_FALSE upon failure
  2471.  */
  2472. NSS_EXTERN PRBool
  2473. NSSPKIXBuiltInStandardAttributes_HasAdministrationDomainName
  2474. (
  2475.   NSSPKIXBuiltInStandardAttributes *bisa,
  2476.   PRStatus *statusOpt
  2477. );
  2478. /*
  2479.  * NSSPKIXBuiltInStandardAttributes_GetAdministrationDomainName
  2480.  *
  2481.  * -- fgmr comments --
  2482.  *
  2483.  * The error may be one of the following values:
  2484.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2485.  *  NSS_ERROR_NO_MEMORY
  2486.  *  NSS_ERROR_INVALID_ARENA
  2487.  *
  2488.  * Return value:
  2489.  *  A valid pointer to an NSSPKIXAdministrationDomainName upon success
  2490.  *  NULL upon failure
  2491.  */
  2492. NSS_EXTERN NSSPKIXAdministrationDomainName *
  2493. NSSPKIXBuiltInStandardAttributes_GetAdministrationDomainName
  2494. (
  2495.   NSSPKIXBuiltInStandardAttributes *bisa,
  2496.   NSSArena *arenaOpt
  2497. );
  2498. /*
  2499.  * NSSPKIXBuiltInStandardAttributes_SetAdministrationDomainName
  2500.  *
  2501.  * -- fgmr comments --
  2502.  *
  2503.  * The error may be one of the following values:
  2504.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2505.  *  NSS_ERROR_NO_MEMORY
  2506.  *  NSS_ERROR_INVALID_PKIX_ADMINISTRATION_DOMAIN_NAME
  2507.  *
  2508.  * Return value:
  2509.  *  PR_SUCCESS upon success
  2510.  *  PR_FAILURE upon failure
  2511.  */
  2512. NSS_EXTERN PRStatus
  2513. NSSPKIXBuiltInStandardAttributes_SetAdministrationDomainName
  2514. (
  2515.   NSSPKIXBuiltInStandardAttributes *bisa,
  2516.   NSSPKIXAdministrationDomainName *administrationDomainName
  2517. );
  2518. /*
  2519.  * NSSPKIXBuiltInStandardAttributes_RemoveAdministrationDomainName
  2520.  *
  2521.  * -- fgmr comments --
  2522.  *
  2523.  * The error may be one of the following values:
  2524.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2525.  *  NSS_ERROR_NO_ADMINISTRATION_DOMAIN_NAME
  2526.  *
  2527.  * Return value:
  2528.  *  PR_SUCCESS upon success
  2529.  *  PR_FAILURE upon failure
  2530.  */
  2531. NSS_EXTERN PRStatus
  2532. NSSPKIXBuiltInStandardAttributes_RemoveAdministrationDomainName
  2533. (
  2534.   NSSPKIXBuiltInStandardAttributes *bisa
  2535. );
  2536. /*
  2537.  * NSSPKIXBuiltInStandardAttributes_HasNetworkAddress
  2538.  *
  2539.  * -- fgmr comments --
  2540.  *
  2541.  * The error may be one of the following values:
  2542.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2543.  *
  2544.  * Return value:
  2545.  *  PR_TRUE if it has one
  2546.  *  PR_FALSE if it doesn't
  2547.  *  PR_FALSE upon failure
  2548.  */
  2549. NSS_EXTERN PRBool
  2550. NSSPKIXBuiltInStandardAttributes_HasNetworkAddress
  2551. (
  2552.   NSSPKIXBuiltInStandardAttributes *bisa,
  2553.   PRStatus *statusOpt
  2554. );
  2555. /*
  2556.  * NSSPKIXBuiltInStandardAttributes_GetNetworkAddress
  2557.  *
  2558.  * -- fgmr comments --
  2559.  *
  2560.  * The error may be one of the following values:
  2561.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2562.  *  NSS_ERROR_NO_MEMORY
  2563.  *  NSS_ERROR_INVALID_ARENA
  2564.  *
  2565.  * Return value:
  2566.  *  A valid pointer to an NSSPKIXNetworkAddress upon success
  2567.  *  NULL upon failure
  2568.  */
  2569. NSS_EXTERN NSSPKIXNetworkAddress *
  2570. NSSPKIXBuiltInStandardAttributes_GetNetworkAddress
  2571. (
  2572.   NSSPKIXBuiltInStandardAttributes *bisa,
  2573.   NSSArena *arenaOpt
  2574. );
  2575. /*
  2576.  * NSSPKIXBuiltInStandardAttributes_SetNetworkAddress
  2577.  *
  2578.  * -- fgmr comments --
  2579.  *
  2580.  * The error may be one of the following values:
  2581.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2582.  *  NSS_ERROR_NO_MEMORY
  2583.  *  NSS_ERROR_INVALID_PKIX_NETWORK_ADDRESS
  2584.  *
  2585.  * Return value:
  2586.  *  PR_SUCCESS upon success
  2587.  *  PR_FAILURE upon failure
  2588.  */
  2589. NSS_EXTERN PRStatus
  2590. NSSPKIXBuiltInStandardAttributes_SetNetworkAddress
  2591. (
  2592.   NSSPKIXBuiltInStandardAttributes *bisa,
  2593.   NSSPKIXNetworkAddress *networkAddress
  2594. );
  2595. /*
  2596.  * NSSPKIXBuiltInStandardAttributes_RemoveNetworkAddress
  2597.  *
  2598.  * -- fgmr comments --
  2599.  *
  2600.  * The error may be one of the following values:
  2601.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2602.  *  NSS_ERROR_NO_NETWORK_ADDRESS
  2603.  *
  2604.  * Return value:
  2605.  *  PR_SUCCESS upon success
  2606.  *  PR_FAILURE upon failure
  2607.  */
  2608. NSS_EXTERN PRStatus
  2609. NSSPKIXBuiltInStandardAttributes_RemoveNetworkAddress
  2610. (
  2611.   NSSPKIXBuiltInStandardAttributes *bisa
  2612. );
  2613. /*
  2614.  * NSSPKIXBuiltInStandardAttributes_HasTerminalIdentifier
  2615.  *
  2616.  * -- fgmr comments --
  2617.  *
  2618.  * The error may be one of the following values:
  2619.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2620.  *
  2621.  * Return value:
  2622.  *  PR_TRUE if it has one
  2623.  *  PR_FALSE if it doesn't
  2624.  *  PR_FALSE upon failure
  2625.  */
  2626. NSS_EXTERN PRBool
  2627. NSSPKIXBuiltInStandardAttributes_HasTerminalIdentifier
  2628. (
  2629.   NSSPKIXBuiltInStandardAttributes *bisa,
  2630.   PRStatus *statusOpt
  2631. );
  2632. /*
  2633.  * NSSPKIXBuiltInStandardAttributes_GetTerminalIdentifier
  2634.  *
  2635.  * -- fgmr comments --
  2636.  *
  2637.  * The error may be one of the following values:
  2638.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2639.  *  NSS_ERROR_NO_MEMORY
  2640.  *  NSS_ERROR_INVALID_ARENA
  2641.  *
  2642.  * Return value:
  2643.  *  A valid pointer to an NSSPKIXTerminalIdentifier upon success
  2644.  *  NULL upon failure
  2645.  */
  2646. NSS_EXTERN NSSPKIXTerminalIdentifier *
  2647. NSSPKIXBuiltInStandardAttributes_GetTerminalIdentifier
  2648. (
  2649.   NSSPKIXBuiltInStandardAttributes *bisa,
  2650.   NSSArena *arenaOpt
  2651. );
  2652. /*
  2653.  * NSSPKIXBuiltInStandardAttributes_SetTerminalIdentifier
  2654.  *
  2655.  * -- fgmr comments --
  2656.  *
  2657.  * The error may be one of the following values:
  2658.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2659.  *  NSS_ERROR_NO_MEMORY
  2660.  *  NSS_ERROR_INVALID_PKIX_TERMINAL_IDENTIFIER
  2661.  *
  2662.  * Return value:
  2663.  *  PR_SUCCESS upon success
  2664.  *  PR_FAILURE upon failure
  2665.  */
  2666. NSS_EXTERN PRStatus
  2667. NSSPKIXBuiltInStandardAttributes_SetTerminalIdentifier
  2668. (
  2669.   NSSPKIXBuiltInStandardAttributes *bisa,
  2670.   NSSPKIXTerminalIdentifier *terminalIdentifier
  2671. );
  2672. /*
  2673.  * NSSPKIXBuiltInStandardAttributes_RemoveTerminalIdentifier
  2674.  *
  2675.  * -- fgmr comments --
  2676.  *
  2677.  * The error may be one of the following values:
  2678.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2679.  *  NSS_ERROR_NO_TERMINAL_IDENTIFIER
  2680.  *
  2681.  * Return value:
  2682.  *  PR_SUCCESS upon success
  2683.  *  PR_FAILURE upon failure
  2684.  */
  2685. NSS_EXTERN PRStatus
  2686. NSSPKIXBuiltInStandardAttributes_RemoveTerminalIdentifier
  2687. (
  2688.   NSSPKIXBuiltInStandardAttributes *bisa
  2689. );
  2690. /*
  2691.  * NSSPKIXBuiltInStandardAttributes_HasPrivateDomainName
  2692.  *
  2693.  * -- fgmr comments --
  2694.  *
  2695.  * The error may be one of the following values:
  2696.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2697.  *
  2698.  * Return value:
  2699.  *  PR_TRUE if it has one
  2700.  *  PR_FALSE if it doesn't
  2701.  *  PR_FALSE upon failure
  2702.  */
  2703. NSS_EXTERN PRBool
  2704. NSSPKIXBuiltInStandardAttributes_HasPrivateDomainName
  2705. (
  2706.   NSSPKIXBuiltInStandardAttributes *bisa,
  2707.   PRStatus *statusOpt
  2708. );
  2709. /*
  2710.  * NSSPKIXBuiltInStandardAttributes_GetPrivateDomainName
  2711.  *
  2712.  * -- fgmr comments --
  2713.  *
  2714.  * The error may be one of the following values:
  2715.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2716.  *  NSS_ERROR_NO_MEMORY
  2717.  *  NSS_ERROR_INVALID_ARENA
  2718.  *
  2719.  * Return value:
  2720.  *  A valid pointer to an NSSPKIXPrivateDomainName upon success
  2721.  *  NULL upon failure
  2722.  */
  2723. NSS_EXTERN NSSPKIXPrivateDomainName *
  2724. NSSPKIXBuiltInStandardAttributes_GetPrivateDomainName
  2725. (
  2726.   NSSPKIXBuiltInStandardAttributes *bisa,
  2727.   NSSArena *arenaOpt
  2728. );
  2729. /*
  2730.  * NSSPKIXBuiltInStandardAttributes_SetPrivateDomainName
  2731.  *
  2732.  * -- fgmr comments --
  2733.  *
  2734.  * The error may be one of the following values:
  2735.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2736.  *  NSS_ERROR_NO_MEMORY
  2737.  *  NSS_ERROR_INVALID_PKIX_PRIVATE_DOMAIN_NAME
  2738.  *
  2739.  * Return value:
  2740.  *  PR_SUCCESS upon success
  2741.  *  PR_FAILURE upon failure
  2742.  */
  2743. NSS_EXTERN PRStatus
  2744. NSSPKIXBuiltInStandardAttributes_SetPrivateDomainName
  2745. (
  2746.   NSSPKIXBuiltInStandardAttributes *bisa,
  2747.   NSSPKIXPrivateDomainName *privateDomainName
  2748. );
  2749. /*
  2750.  * NSSPKIXBuiltInStandardAttributes_RemovePrivateDomainName
  2751.  *
  2752.  * -- fgmr comments --
  2753.  *
  2754.  * The error may be one of the following values:
  2755.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2756.  *  NSS_ERROR_NO_PRIVATE_DOMAIN_NAME
  2757.  *
  2758.  * Return value:
  2759.  *  PR_SUCCESS upon success
  2760.  *  PR_FAILURE upon failure
  2761.  */
  2762. NSS_EXTERN PRStatus
  2763. NSSPKIXBuiltInStandardAttributes_RemovePrivateDomainName
  2764. (
  2765.   NSSPKIXBuiltInStandardAttributes *bisa
  2766. );
  2767. /*
  2768.  * NSSPKIXBuiltInStandardAttributes_HasOrganizationName
  2769.  *
  2770.  * -- fgmr comments --
  2771.  *
  2772.  * The error may be one of the following values:
  2773.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2774.  *
  2775.  * Return value:
  2776.  *  PR_TRUE if it has one
  2777.  *  PR_FALSE if it doesn't
  2778.  *  PR_FALSE upon failure
  2779.  */
  2780. NSS_EXTERN PRBool
  2781. NSSPKIXBuiltInStandardAttributes_HasOrganizationName
  2782. (
  2783.   NSSPKIXBuiltInStandardAttributes *bisa,
  2784.   PRStatus *statusOpt
  2785. );
  2786. /*
  2787.  * NSSPKIXBuiltInStandardAttributes_GetOrganizationName
  2788.  *
  2789.  * -- fgmr comments --
  2790.  *
  2791.  * The error may be one of the following values:
  2792.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2793.  *  NSS_ERROR_NO_MEMORY
  2794.  *  NSS_ERROR_INVALID_ARENA
  2795.  *
  2796.  * Return value:
  2797.  *  A valid pointer to an NSSPKIXOrganizationName upon success
  2798.  *  NULL upon failure
  2799.  */
  2800. NSS_EXTERN NSSPKIXOrganizationName *
  2801. NSSPKIXBuiltInStandardAttributes_GetOrganizationName
  2802. (
  2803.   NSSPKIXBuiltInStandardAttributes *bisa,
  2804.   NSSArena *arenaOpt
  2805. );
  2806. /*
  2807.  * NSSPKIXBuiltInStandardAttributes_SetOrganizationName
  2808.  *
  2809.  * -- fgmr comments --
  2810.  *
  2811.  * The error may be one of the following values:
  2812.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2813.  *  NSS_ERROR_NO_MEMORY
  2814.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATION_NAME
  2815.  *
  2816.  * Return value:
  2817.  *  PR_SUCCESS upon success
  2818.  *  PR_FAILURE upon failure
  2819.  */
  2820. NSS_EXTERN PRStatus
  2821. NSSPKIXBuiltInStandardAttributes_SetOrganizationName
  2822. (
  2823.   NSSPKIXBuiltInStandardAttributes *bisa,
  2824.   NSSPKIXOrganizationName *organizationName
  2825. );
  2826. /*
  2827.  * NSSPKIXBuiltInStandardAttributes_RemoveOrganizationName
  2828.  *
  2829.  * -- fgmr comments --
  2830.  *
  2831.  * The error may be one of the following values:
  2832.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2833.  *  NSS_ERROR_NO_ORGANIZATION_NAME
  2834.  *
  2835.  * Return value:
  2836.  *  PR_SUCCESS upon success
  2837.  *  PR_FAILURE upon failure
  2838.  */
  2839. NSS_EXTERN PRStatus
  2840. NSSPKIXBuiltInStandardAttributes_RemoveOrganizationName
  2841. (
  2842.   NSSPKIXBuiltInStandardAttributes *bisa
  2843. );
  2844. /*
  2845.  * NSSPKIXBuiltInStandardAttributes_HasNumericUserIdentifier
  2846.  *
  2847.  * -- fgmr comments --
  2848.  *
  2849.  * The error may be one of the following values:
  2850.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2851.  *
  2852.  * Return value:
  2853.  *  PR_TRUE if it has one
  2854.  *  PR_FALSE if it doesn't
  2855.  *  PR_FALSE upon failure
  2856.  */
  2857. NSS_EXTERN PRBool
  2858. NSSPKIXBuiltInStandardAttributes_HasNumericUserIdentifier
  2859. (
  2860.   NSSPKIXBuiltInStandardAttributes *bisa,
  2861.   PRStatus *statusOpt
  2862. );
  2863. /*
  2864.  * NSSPKIXBuiltInStandardAttributes_GetNumericUserIdentifier
  2865.  *
  2866.  * -- fgmr comments --
  2867.  *
  2868.  * The error may be one of the following values:
  2869.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2870.  *  NSS_ERROR_NO_MEMORY
  2871.  *  NSS_ERROR_INVALID_ARENA
  2872.  *
  2873.  * Return value:
  2874.  *  A valid pointer to an NSSPKIXNumericUserIdentifier upon success
  2875.  *  NULL upon failure
  2876.  */
  2877. NSS_EXTERN NSSPKIXNumericUserIdentifier *
  2878. NSSPKIXBuiltInStandardAttributes_GetNumericUserIdentifier
  2879. (
  2880.   NSSPKIXBuiltInStandardAttributes *bisa,
  2881.   NSSArena *arenaOpt
  2882. );
  2883. /*
  2884.  * NSSPKIXBuiltInStandardAttributes_SetNumericUserIdentifier
  2885.  *
  2886.  * -- fgmr comments --
  2887.  *
  2888.  * The error may be one of the following values:
  2889.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2890.  *  NSS_ERROR_NO_MEMORY
  2891.  *  NSS_ERROR_INVALID_PKIX_NUMERIC_USER_IDENTIFIER
  2892.  *
  2893.  * Return value:
  2894.  *  PR_SUCCESS upon success
  2895.  *  PR_FAILURE upon failure
  2896.  */
  2897. NSS_EXTERN PRStatus
  2898. NSSPKIXBuiltInStandardAttributes_SetNumericUserIdentifier
  2899. (
  2900.   NSSPKIXBuiltInStandardAttributes *bisa,
  2901.   NSSPKIXNumericUserIdentifier *numericUserIdentifier
  2902. );
  2903. /*
  2904.  * NSSPKIXBuiltInStandardAttributes_RemoveNumericUserIdentifier
  2905.  *
  2906.  * -- fgmr comments --
  2907.  *
  2908.  * The error may be one of the following values:
  2909.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2910.  *  NSS_ERROR_NO_NUMERIC_USER_IDENTIFIER
  2911.  *
  2912.  * Return value:
  2913.  *  PR_SUCCESS upon success
  2914.  *  PR_FAILURE upon failure
  2915.  */
  2916. NSS_EXTERN PRStatus
  2917. NSSPKIXBuiltInStandardAttributes_RemoveNumericUserIdentifier
  2918. (
  2919.   NSSPKIXBuiltInStandardAttributes *bisa
  2920. );
  2921. /*
  2922.  * NSSPKIXBuiltInStandardAttributes_HasPersonalName
  2923.  *
  2924.  * -- fgmr comments --
  2925.  *
  2926.  * The error may be one of the following values:
  2927.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2928.  *
  2929.  * Return value:
  2930.  *  PR_TRUE if it has one
  2931.  *  PR_FALSE if it doesn't
  2932.  *  PR_FALSE upon failure
  2933.  */
  2934. NSS_EXTERN PRBool
  2935. NSSPKIXBuiltInStandardAttributes_HasPersonalName
  2936. (
  2937.   NSSPKIXBuiltInStandardAttributes *bisa,
  2938.   PRStatus *statusOpt
  2939. );
  2940. /*
  2941.  * NSSPKIXBuiltInStandardAttributes_GetPersonalName
  2942.  *
  2943.  * -- fgmr comments --
  2944.  *
  2945.  * The error may be one of the following values:
  2946.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2947.  *  NSS_ERROR_NO_MEMORY
  2948.  *  NSS_ERROR_INVALID_ARENA
  2949.  *
  2950.  * Return value:
  2951.  *  A valid pointer to an NSSPKIXPersonalName upon success
  2952.  *  NULL upon failure
  2953.  */
  2954. NSS_EXTERN NSSPKIXPersonalName *
  2955. NSSPKIXBuiltInStandardAttributes_GetPersonalName
  2956. (
  2957.   NSSPKIXBuiltInStandardAttributes *bisa,
  2958.   NSSArena *arenaOpt
  2959. );
  2960. /*
  2961.  * NSSPKIXBuiltInStandardAttributes_SetPersonalName
  2962.  *
  2963.  * -- fgmr comments --
  2964.  *
  2965.  * The error may be one of the following values:
  2966.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2967.  *  NSS_ERROR_NO_MEMORY
  2968.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  2969.  *
  2970.  * Return value:
  2971.  *  PR_SUCCESS upon success
  2972.  *  PR_FAILURE upon failure
  2973.  */
  2974. NSS_EXTERN PRStatus
  2975. NSSPKIXBuiltInStandardAttributes_SetPersonalName
  2976. (
  2977.   NSSPKIXBuiltInStandardAttributes *bisa,
  2978.   NSSPKIXPersonalName *personalName
  2979. );
  2980. /*
  2981.  * NSSPKIXBuiltInStandardAttributes_RemovePersonalName
  2982.  *
  2983.  * -- fgmr comments --
  2984.  *
  2985.  * The error may be one of the following values:
  2986.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  2987.  *  NSS_ERROR_NO_PERSONAL_NAME
  2988.  *
  2989.  * Return value:
  2990.  *  PR_SUCCESS upon success
  2991.  *  PR_FAILURE upon failure
  2992.  */
  2993. NSS_EXTERN PRStatus
  2994. NSSPKIXBuiltInStandardAttributes_RemovePersonalName
  2995. (
  2996.   NSSPKIXBuiltInStandardAttributes *bisa
  2997. );
  2998. /*
  2999.  * NSSPKIXBuiltInStandardAttributes_HasOrganizationLUnitNames
  3000.  *
  3001.  * -- fgmr comments --
  3002.  *
  3003.  * The error may be one of the following values:
  3004.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  3005.  *
  3006.  * Return value:
  3007.  *  PR_TRUE if it has one
  3008.  *  PR_FALSE if it doesn't
  3009.  *  PR_FALSE upon failure
  3010.  */
  3011. NSS_EXTERN PRBool
  3012. NSSPKIXBuiltInStandardAttributes_HasOrganizationLUnitNames
  3013. (
  3014.   NSSPKIXBuiltInStandardAttributes *bisa,
  3015.   PRStatus *statusOpt
  3016. );
  3017. /*
  3018.  * NSSPKIXBuiltInStandardAttributes_GetOrganizationLUnitNames
  3019.  *
  3020.  * -- fgmr comments --
  3021.  *
  3022.  * The error may be one of the following values:
  3023.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  3024.  *  NSS_ERROR_NO_MEMORY
  3025.  *  NSS_ERROR_INVALID_ARENA
  3026.  *
  3027.  * Return value:
  3028.  *  A valid pointer to an NSSPKIXOrganizationalUnitNames upon success
  3029.  *  NULL upon failure
  3030.  */
  3031. NSS_EXTERN NSSPKIXOrganizationalUnitNames *
  3032. NSSPKIXBuiltInStandardAttributes_GetOrganizationLUnitNames
  3033. (
  3034.   NSSPKIXBuiltInStandardAttributes *bisa,
  3035.   NSSArena *arenaOpt
  3036. );
  3037. /*
  3038.  * NSSPKIXBuiltInStandardAttributes_SetOrganizationLUnitNames
  3039.  *
  3040.  * -- fgmr comments --
  3041.  *
  3042.  * The error may be one of the following values:
  3043.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  3044.  *  NSS_ERROR_NO_MEMORY
  3045.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
  3046.  *
  3047.  * Return value:
  3048.  *  PR_SUCCESS upon success
  3049.  *  PR_FAILURE upon failure
  3050.  */
  3051. NSS_EXTERN PRStatus
  3052. NSSPKIXBuiltInStandardAttributes_SetOrganizationLUnitNames
  3053. (
  3054.   NSSPKIXBuiltInStandardAttributes *bisa,
  3055.   NSSPKIXOrganizationalUnitNames *organizationalUnitNames
  3056. );
  3057. /*
  3058.  * NSSPKIXBuiltInStandardAttributes_RemoveOrganizationLUnitNames
  3059.  *
  3060.  * -- fgmr comments --
  3061.  *
  3062.  * The error may be one of the following values:
  3063.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  3064.  *  NSS_ERROR_NO_ORGANIZATIONAL_UNIT_NAMES
  3065.  *
  3066.  * Return value:
  3067.  *  PR_SUCCESS upon success
  3068.  *  PR_FAILURE upon failure
  3069.  */
  3070. NSS_EXTERN PRStatus
  3071. NSSPKIXBuiltInStandardAttributes_RemoveOrganizationLUnitNames
  3072. (
  3073.   NSSPKIXBuiltInStandardAttributes *bisa
  3074. );
  3075. /*
  3076.  * NSSPKIXBuiltInStandardAttributes_Equal
  3077.  *
  3078.  * -- fgmr comments --
  3079.  *
  3080.  * The error may be one of the following values:
  3081.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  3082.  *
  3083.  * Return value:
  3084.  *  PR_TRUE if the two objects have equal values
  3085.  *  PR_FALSE otherwise
  3086.  *  PR_FALSE upon error
  3087.  */
  3088. NSS_EXTERN PRBool
  3089. NSSPKIXBuiltInStandardAttributes_Equal
  3090. (
  3091.   NSSPKIXBuiltInStandardAttributes *bisa1,
  3092.   NSSPKIXBuiltInStandardAttributes *bisa2,
  3093.   PRStatus *statusOpt
  3094. );
  3095. /*
  3096.  * NSSPKIXBuiltInStandardAttributes_Duplicate
  3097.  *
  3098.  * -- fgmr comments --
  3099.  *
  3100.  * The error may be one of the following values:
  3101.  *  NSS_ERROR_INVALID_PKIX_BUILT_IN_STANDARD_ATTRIBUTES
  3102.  *  NSS_ERROR_NO_MEMORY
  3103.  *  NSS_ERROR_INVALID_ARENA
  3104.  *
  3105.  * Return value:
  3106.  *  A valid pointer to an NSSPKIXBuiltInStandardAttributes upon success
  3107.  *  NULL upon failure
  3108.  */
  3109. NSS_EXTERN NSSPKIXBuiltInStandardAttributes *
  3110. NSSPKIXBuiltInStandardAttributes_Duplicate
  3111. (
  3112.   NSSPKIXBuiltInStandardAttributes *bisa,
  3113.   NSSArena *arenaOpt
  3114. );
  3115. /*
  3116.  * CountryName
  3117.  *
  3118.  * -- fgmr comments --
  3119.  *
  3120.  * From RFC 2459:
  3121.  *
  3122.  *  CountryName ::= [APPLICATION 1] CHOICE {
  3123.  *     x121-dcc-code NumericString
  3124.  *                  (SIZE (ub-country-name-numeric-length)),
  3125.  *     iso-3166-alpha2-code PrintableString
  3126.  *                  (SIZE (ub-country-name-alpha-length)) }
  3127.  *
  3128.  * The public calls for this type:
  3129.  *
  3130.  *  NSSPKIXCountryName_Decode
  3131.  *  NSSPKIXCountryName_CreateFromUTF8
  3132.  *  NSSPKIXCountryName_Encode
  3133.  *
  3134.  */
  3135. /*
  3136.  * NSSPKIXCountryName_Decode
  3137.  *
  3138.  * -- fgmr comments --
  3139.  *
  3140.  * The error may be one of the following values:
  3141.  *  NSS_ERROR_INVALID_BER
  3142.  *  NSS_ERROR_NO_MEMORY
  3143.  *  NSS_ERROR_INVALID_ARENA
  3144.  * 
  3145.  * Return value:
  3146.  *  A valid pointer to an NSSPKIXCountryName upon success
  3147.  *  NULL upon failure
  3148.  */
  3149. NSS_EXTERN NSSPKIXCountryName *
  3150. NSSPKIXCountryName_Decode
  3151. (
  3152.   NSSArena *arenaOpt,
  3153.   NSSBER *ber
  3154. );
  3155. /*
  3156.  * NSSPKIXCountryName_CreateFromUTF8
  3157.  *
  3158.  * { basically just enforces the length limit }
  3159.  *
  3160.  * The error may be one of the following values:
  3161.  *  NSS_ERROR_INVALID_BER
  3162.  *  NSS_ERROR_NO_MEMORY
  3163.  *  NSS_ERROR_INVALID_ARENA
  3164.  * 
  3165.  * Return value:
  3166.  *  A valid pointer to an NSSPKIXCountryName upon success
  3167.  *  NULL upon failure
  3168.  */
  3169. NSS_EXTERN NSSPKIXCountryName *
  3170. NSSPKIXCountryName_CreateFromUTF8
  3171. (
  3172.   NSSArena *arenaOpt,
  3173.   NSSUTF8 *utf8
  3174. );
  3175. /*
  3176.  * NSSPKIXCountryName_Encode
  3177.  *
  3178.  *
  3179.  *
  3180.  * The error may be one of the following values:
  3181.  *  NSS_ERROR_INVALID_PKIX_COUNTRY_NAME
  3182.  *  NSS_ERROR_NO_MEMORY
  3183.  *
  3184.  * Return value:
  3185.  *  A valid NSSBER pointer upon success
  3186.  *  NULL upon failure
  3187.  */
  3188. NSS_EXTERN NSSBER *
  3189. NSSPKIXCountryName_Encode
  3190. (
  3191.   NSSPKIXCountryName *name,
  3192.   NSSASN1EncodingType encoding,
  3193.   NSSBER *rvOpt,
  3194.   NSSArena *arenaOpt
  3195. );
  3196. /*
  3197.  * AdministrationDomainName
  3198.  *
  3199.  * -- fgmr comments --
  3200.  *
  3201.  * From RFC 2459:
  3202.  *
  3203.  *  AdministrationDomainName ::= [APPLICATION 2] CHOICE {
  3204.  *     numeric NumericString (SIZE (0..ub-domain-name-length)),
  3205.  *     printable PrintableString (SIZE (0..ub-domain-name-length)) }
  3206.  *
  3207.  * The public calls for this type:
  3208.  *
  3209.  *  NSSPKIXAdministrationDomainName_Decode
  3210.  *  NSSPKIXAdministrationDomainName_CreateFromUTF8
  3211.  *  NSSPKIXAdministrationDomainName_Encode
  3212.  *
  3213.  */
  3214. /*
  3215.  * NSSPKIXAdministrationDomainName_Decode
  3216.  *
  3217.  * -- fgmr comments --
  3218.  *
  3219.  * The error may be one of the following values:
  3220.  *  NSS_ERROR_INVALID_BER
  3221.  *  NSS_ERROR_NO_MEMORY
  3222.  *  NSS_ERROR_INVALID_ARENA
  3223.  * 
  3224.  * Return value:
  3225.  *  A valid pointer to an NSSPKIXAdministrationDomainName upon success
  3226.  *  NULL upon failure
  3227.  */
  3228. NSS_EXTERN NSSPKIXAdministrationDomainName *
  3229. NSSPKIXAdministrationDomainName_Decode
  3230. (
  3231.   NSSArena *arenaOpt,
  3232.   NSSBER *ber
  3233. );
  3234. /*
  3235.  * NSSPKIXAdministrationDomainName_CreateFromUTF8
  3236.  *
  3237.  * { basically just enforces the length limit }
  3238.  *
  3239.  * The error may be one of the following values:
  3240.  *  NSS_ERROR_INVALID_BER
  3241.  *  NSS_ERROR_NO_MEMORY
  3242.  *  NSS_ERROR_INVALID_ARENA
  3243.  * 
  3244.  * Return value:
  3245.  *  A valid pointer to an NSSPKIXAdministrationDomainName upon success
  3246.  *  NULL upon failure
  3247.  */
  3248. NSS_EXTERN NSSPKIXAdministrationDomainName *
  3249. NSSPKIXAdministrationDomainName_CreateFromUTF8
  3250. (
  3251.   NSSArena *arenaOpt,
  3252.   NSSUTF8 *utf8
  3253. );
  3254. /*
  3255.  * NSSPKIXAdministrationDomainName_Encode
  3256.  *
  3257.  *
  3258.  *
  3259.  * The error may be one of the following values:
  3260.  *  NSS_ERROR_INVALID_PKIX_ADMINISTRATION_DOMAIN_NAME
  3261.  *  NSS_ERROR_NO_MEMORY
  3262.  *
  3263.  * Return value:
  3264.  *  A valid NSSBER pointer upon success
  3265.  *  NULL upon failure
  3266.  */
  3267. NSS_EXTERN NSSBER *
  3268. NSSPKIXAdministrationDomainName_Encode
  3269. (
  3270.   NSSPKIXAdministrationDomainName *name,
  3271.   NSSASN1EncodingType encoding,
  3272.   NSSBER *rvOpt,
  3273.   NSSArena *arenaOpt
  3274. );
  3275. /*
  3276.  * X121Address
  3277.  *
  3278.  * -- fgmr comments --
  3279.  *
  3280.  * From RFC 2459:
  3281.  *
  3282.  *  X121Address ::= NumericString (SIZE (1..ub-x121-address-length))
  3283.  *
  3284.  * The public calls for this type:
  3285.  *
  3286.  *  NSSPKIXX121Address_Decode
  3287.  *  NSSPKIXX121Address_CreateFromUTF8
  3288.  *  NSSPKIXX121Address_Encode
  3289.  *
  3290.  */
  3291. /*
  3292.  * NSSPKIXX121Address_Decode
  3293.  *
  3294.  * -- fgmr comments --
  3295.  *
  3296.  * The error may be one of the following values:
  3297.  *  NSS_ERROR_INVALID_BER
  3298.  *  NSS_ERROR_NO_MEMORY
  3299.  *  NSS_ERROR_INVALID_ARENA
  3300.  * 
  3301.  * Return value:
  3302.  *  A valid pointer to an NSSPKIXX121Address upon success
  3303.  *  NULL upon failure
  3304.  */
  3305. NSS_EXTERN NSSPKIXX121Address *
  3306. NSSPKIXX121Address_Decode
  3307. (
  3308.   NSSArena *arenaOpt,
  3309.   NSSBER *ber
  3310. );
  3311. /*
  3312.  * NSSPKIXX121Address_CreateFromUTF8
  3313.  *
  3314.  * { basically just enforces the length limit }
  3315.  *
  3316.  * The error may be one of the following values:
  3317.  *  NSS_ERROR_INVALID_BER
  3318.  *  NSS_ERROR_NO_MEMORY
  3319.  *  NSS_ERROR_INVALID_ARENA
  3320.  * 
  3321.  * Return value:
  3322.  *  A valid pointer to an NSSPKIXX121Address upon success
  3323.  *  NULL upon failure
  3324.  */
  3325. NSS_EXTERN NSSPKIXX121Address *
  3326. NSSPKIXX121Address_CreateFromUTF8
  3327. (
  3328.   NSSArena *arenaOpt,
  3329.   NSSUTF8 *utf8
  3330. );
  3331. /*
  3332.  * NSSPKIXX121Address_Encode
  3333.  *
  3334.  *
  3335.  *
  3336.  * The error may be one of the following values:
  3337.  *  NSS_ERROR_INVALID_PKIX_X121_ADDRESS
  3338.  *  NSS_ERROR_NO_MEMORY
  3339.  *
  3340.  * Return value:
  3341.  *  A valid NSSBER pointer upon success
  3342.  *  NULL upon failure
  3343.  */
  3344. NSS_EXTERN NSSBER *
  3345. NSSPKIXX121Address_Encode
  3346. (
  3347.   NSSPKIXX121Address *name,
  3348.   NSSASN1EncodingType encoding,
  3349.   NSSBER *rvOpt,
  3350.   NSSArena *arenaOpt
  3351. );
  3352. /*
  3353.  * NetworkAddress
  3354.  *
  3355.  * -- fgmr comments --
  3356.  *
  3357.  * From RFC 2459:
  3358.  *
  3359.  *  NetworkAddress ::= X121Address  -- see also extended-network-address
  3360.  *
  3361.  * The public calls for this type:
  3362.  *
  3363.  *  NSSPKIXNetworkAddress_Decode
  3364.  *  NSSPKIXNetworkAddress_CreateFromUTF8
  3365.  *  NSSPKIXNetworkAddress_Encode
  3366.  *
  3367.  */
  3368. /*
  3369.  * NSSPKIXNetworkAddress_Decode
  3370.  *
  3371.  * -- fgmr comments --
  3372.  *
  3373.  * The error may be one of the following values:
  3374.  *  NSS_ERROR_INVALID_BER
  3375.  *  NSS_ERROR_NO_MEMORY
  3376.  *  NSS_ERROR_INVALID_ARENA
  3377.  * 
  3378.  * Return value:
  3379.  *  A valid pointer to an NSSPKIXNetworkAddress upon success
  3380.  *  NULL upon failure
  3381.  */
  3382. NSS_EXTERN NSSPKIXNetworkAddress *
  3383. NSSPKIXNetworkAddress_Decode
  3384. (
  3385.   NSSArena *arenaOpt,
  3386.   NSSBER *ber
  3387. );
  3388. /*
  3389.  * NSSPKIXNetworkAddress_CreateFromUTF8
  3390.  *
  3391.  * { basically just enforces the length limit }
  3392.  *
  3393.  * The error may be one of the following values:
  3394.  *  NSS_ERROR_INVALID_BER
  3395.  *  NSS_ERROR_NO_MEMORY
  3396.  *  NSS_ERROR_INVALID_ARENA
  3397.  * 
  3398.  * Return value:
  3399.  *  A valid pointer to an NSSPKIXNetworkAddress upon success
  3400.  *  NULL upon failure
  3401.  */
  3402. NSS_EXTERN NSSPKIXNetworkAddress *
  3403. NSSPKIXNetworkAddress_CreateFromUTF8
  3404. (
  3405.   NSSArena *arenaOpt,
  3406.   NSSUTF8 *utf8
  3407. );
  3408. /*
  3409.  * NSSPKIXNetworkAddress_Encode
  3410.  *
  3411.  *
  3412.  *
  3413.  * The error may be one of the following values:
  3414.  *  NSS_ERROR_INVALID_PKIX_NETWORK_ADDRESS
  3415.  *  NSS_ERROR_NO_MEMORY
  3416.  *
  3417.  * Return value:
  3418.  *  A valid NSSBER pointer upon success
  3419.  *  NULL upon failure
  3420.  */
  3421. NSS_EXTERN NSSBER *
  3422. NSSPKIXNetworkAddress_Encode
  3423. (
  3424.   NSSPKIXNetworkAddress *name,
  3425.   NSSASN1EncodingType encoding,
  3426.   NSSBER *rvOpt,
  3427.   NSSArena *arenaOpt
  3428. );
  3429. /*
  3430.  * TerminalIdentifier
  3431.  *
  3432.  * -- fgmr comments --
  3433.  *
  3434.  * From RFC 2459:
  3435.  *
  3436.  *  TerminalIdentifier ::= PrintableString (SIZE (1..ub-terminal-id-length))
  3437.  *
  3438.  * The public calls for this type:
  3439.  *
  3440.  *  NSSPKIXTerminalIdentifier_Decode
  3441.  *  NSSPKIXTerminalIdentifier_CreateFromUTF8
  3442.  *  NSSPKIXTerminalIdentifier_Encode
  3443.  *
  3444.  */
  3445. /*
  3446.  * NSSPKIXTerminalIdentifier_Decode
  3447.  *
  3448.  * -- fgmr comments --
  3449.  *
  3450.  * The error may be one of the following values:
  3451.  *  NSS_ERROR_INVALID_BER
  3452.  *  NSS_ERROR_NO_MEMORY
  3453.  *  NSS_ERROR_INVALID_ARENA
  3454.  * 
  3455.  * Return value:
  3456.  *  A valid pointer to an NSSPKIXTerminalIdentifier upon success
  3457.  *  NULL upon failure
  3458.  */
  3459. NSS_EXTERN NSSPKIXTerminalIdentifier *
  3460. NSSPKIXTerminalIdentifier_Decode
  3461. (
  3462.   NSSArena *arenaOpt,
  3463.   NSSBER *ber
  3464. );
  3465. /*
  3466.  * NSSPKIXTerminalIdentifier_CreateFromUTF8
  3467.  *
  3468.  * { basically just enforces the length limit }
  3469.  *
  3470.  * The error may be one of the following values:
  3471.  *  NSS_ERROR_INVALID_BER
  3472.  *  NSS_ERROR_NO_MEMORY
  3473.  *  NSS_ERROR_INVALID_ARENA
  3474.  * 
  3475.  * Return value:
  3476.  *  A valid pointer to an NSSPKIXTerminalIdentifier upon success
  3477.  *  NULL upon failure
  3478.  */
  3479. NSS_EXTERN NSSPKIXTerminalIdentifier *
  3480. NSSPKIXTerminalIdentifier_CreateFromUTF8
  3481. (
  3482.   NSSArena *arenaOpt,
  3483.   NSSUTF8 *utf8
  3484. );
  3485. /*
  3486.  * NSSPKIXTerminalIdentifier_Encode
  3487.  *
  3488.  *
  3489.  *
  3490.  * The error may be one of the following values:
  3491.  *  NSS_ERROR_INVALID_PKIX_TERMINAL_IDENTIFIER
  3492.  *  NSS_ERROR_NO_MEMORY
  3493.  *
  3494.  * Return value:
  3495.  *  A valid NSSBER pointer upon success
  3496.  *  NULL upon failure
  3497.  */
  3498. NSS_EXTERN NSSBER *
  3499. NSSPKIXTerminalIdentifier_Encode
  3500. (
  3501.   NSSPKIXTerminalIdentifier *name,
  3502.   NSSASN1EncodingType encoding,
  3503.   NSSBER *rvOpt,
  3504.   NSSArena *arenaOpt
  3505. );
  3506. /*
  3507.  * PrivateDomainName
  3508.  *
  3509.  * -- fgmr comments -- 
  3510.  *
  3511.  *  PrivateDomainName ::= CHOICE {
  3512.  *     numeric NumericString (SIZE (1..ub-domain-name-length)),
  3513.  *     printable PrintableString (SIZE (1..ub-domain-name-length)) }
  3514.  *
  3515.  * The public calls for this type:
  3516.  *
  3517.  *  NSSPKIXPrivateDomainName_Decode
  3518.  *  NSSPKIXPrivateDomainName_CreateFromUTF8
  3519.  *  NSSPKIXPrivateDomainName_Encode
  3520.  *
  3521.  */
  3522. /*
  3523.  * NSSPKIXPrivateDomainName_Decode
  3524.  *
  3525.  * -- fgmr comments --
  3526.  *
  3527.  * The error may be one of the following values:
  3528.  *  NSS_ERROR_INVALID_BER
  3529.  *  NSS_ERROR_NO_MEMORY
  3530.  *  NSS_ERROR_INVALID_ARENA
  3531.  * 
  3532.  * Return value:
  3533.  *  A valid pointer to an NSSPKIXPrivateDomainName upon success
  3534.  *  NULL upon failure
  3535.  */
  3536. NSS_EXTERN NSSPKIXPrivateDomainName *
  3537. NSSPKIXPrivateDomainName_Decode
  3538. (
  3539.   NSSArena *arenaOpt,
  3540.   NSSBER *ber
  3541. );
  3542. /*
  3543.  * NSSPKIXPrivateDomainName_CreateFromUTF8
  3544.  *
  3545.  * { basically just enforces the length limit }
  3546.  *
  3547.  * The error may be one of the following values:
  3548.  *  NSS_ERROR_INVALID_BER
  3549.  *  NSS_ERROR_NO_MEMORY
  3550.  *  NSS_ERROR_INVALID_ARENA
  3551.  * 
  3552.  * Return value:
  3553.  *  A valid pointer to an NSSPKIXPrivateDomainName upon success
  3554.  *  NULL upon failure
  3555.  */
  3556. NSS_EXTERN NSSPKIXPrivateDomainName *
  3557. NSSPKIXPrivateDomainName_CreateFromUTF8
  3558. (
  3559.   NSSArena *arenaOpt,
  3560.   NSSUTF8 *utf8
  3561. );
  3562. /*
  3563.  * NSSPKIXPrivateDomainName_Encode
  3564.  *
  3565.  *
  3566.  *
  3567.  * The error may be one of the following values:
  3568.  *  NSS_ERROR_INVALID_PKIX_PRIVATE_DOMAIN_NAME
  3569.  *  NSS_ERROR_NO_MEMORY
  3570.  *
  3571.  * Return value:
  3572.  *  A valid NSSBER pointer upon success
  3573.  *  NULL upon failure
  3574.  */
  3575. NSS_EXTERN NSSBER *
  3576. NSSPKIXPrivateDomainName_Encode
  3577. (
  3578.   NSSPKIXPrivateDomainName *name,
  3579.   NSSASN1EncodingType encoding,
  3580.   NSSBER *rvOpt,
  3581.   NSSArena *arenaOpt
  3582. );
  3583. /*
  3584.  * OrganizationName
  3585.  *
  3586.  * -- fgmr comments --
  3587.  *
  3588.  *  OrganizationName ::= PrintableString
  3589.  *                              (SIZE (1..ub-organization-name-length))
  3590.  * 
  3591.  * The public calls for this type:
  3592.  *
  3593.  *  NSSPKIXOrganizationName_Decode
  3594.  *  NSSPKIXOrganizationName_CreateFromUTF8
  3595.  *  NSSPKIXOrganizationName_Encode
  3596.  *
  3597.  */
  3598. /*
  3599.  * NSSPKIXOrganizationName_Decode
  3600.  *
  3601.  * -- fgmr comments --
  3602.  *
  3603.  * The error may be one of the following values:
  3604.  *  NSS_ERROR_INVALID_BER
  3605.  *  NSS_ERROR_NO_MEMORY
  3606.  *  NSS_ERROR_INVALID_ARENA
  3607.  * 
  3608.  * Return value:
  3609.  *  A valid pointer to an NSSPKIXOrganizationName upon success
  3610.  *  NULL upon failure
  3611.  */
  3612. NSS_EXTERN NSSPKIXOrganizationName *
  3613. NSSPKIXOrganizationName_Decode
  3614. (
  3615.   NSSArena *arenaOpt,
  3616.   NSSBER *ber
  3617. );
  3618. /*
  3619.  * NSSPKIXOrganizationName_CreateFromUTF8
  3620.  *
  3621.  * { basically just enforces the length limit }
  3622.  *
  3623.  * The error may be one of the following values:
  3624.  *  NSS_ERROR_INVALID_BER
  3625.  *  NSS_ERROR_NO_MEMORY
  3626.  *  NSS_ERROR_INVALID_ARENA
  3627.  * 
  3628.  * Return value:
  3629.  *  A valid pointer to an NSSPKIXOrganizationName upon success
  3630.  *  NULL upon failure
  3631.  */
  3632. NSS_EXTERN NSSPKIXOrganizationName *
  3633. NSSPKIXOrganizationName_CreateFromUTF8
  3634. (
  3635.   NSSArena *arenaOpt,
  3636.   NSSUTF8 *utf8
  3637. );
  3638. /*
  3639.  * NSSPKIXOrganizationName_Encode
  3640.  *
  3641.  *
  3642.  *
  3643.  * The error may be one of the following values:
  3644.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATION_NAME
  3645.  *  NSS_ERROR_NO_MEMORY
  3646.  *
  3647.  * Return value:
  3648.  *  A valid NSSBER pointer upon success
  3649.  *  NULL upon failure
  3650.  */
  3651. NSS_EXTERN NSSBER *
  3652. NSSPKIXOrganizationName_Encode
  3653. (
  3654.   NSSPKIXOrganizationName *name,
  3655.   NSSASN1EncodingType encoding,
  3656.   NSSBER *rvOpt,
  3657.   NSSArena *arenaOpt
  3658. );
  3659. /*
  3660.  * NumericUserIdentifier
  3661.  *
  3662.  * -- fgmr comments --
  3663.  *
  3664.  * From RFC 2459:
  3665.  *
  3666.  *  NumericUserIdentifier ::= NumericString
  3667.  *                              (SIZE (1..ub-numeric-user-id-length))
  3668.  * 
  3669.  * The public calls for this type:
  3670.  *
  3671.  *  NSSPKIXNumericUserIdentifier_Decode
  3672.  *  NSSPKIXNumericUserIdentifier_CreateFromUTF8
  3673.  *  NSSPKIXNumericUserIdentifier_Encode
  3674.  *
  3675.  */
  3676. /*
  3677.  * NSSPKIXNumericUserIdentifier_Decode
  3678.  *
  3679.  * -- fgmr comments --
  3680.  *
  3681.  * The error may be one of the following values:
  3682.  *  NSS_ERROR_INVALID_BER
  3683.  *  NSS_ERROR_NO_MEMORY
  3684.  *  NSS_ERROR_INVALID_ARENA
  3685.  * 
  3686.  * Return value:
  3687.  *  A valid pointer to an NSSPKIXNumericUserIdentifier upon success
  3688.  *  NULL upon failure
  3689.  */
  3690. NSS_EXTERN NSSPKIXNumericUserIdentifier *
  3691. NSSPKIXNumericUserIdentifier_Decode
  3692. (
  3693.   NSSArena *arenaOpt,
  3694.   NSSBER *ber
  3695. );
  3696. /*
  3697.  * NSSPKIXNumericUserIdentifier_CreateFromUTF8
  3698.  *
  3699.  * { basically just enforces the length limit }
  3700.  *
  3701.  * The error may be one of the following values:
  3702.  *  NSS_ERROR_INVALID_UTF8
  3703.  *  NSS_ERROR_NO_MEMORY
  3704.  *  NSS_ERROR_INVALID_ARENA
  3705.  * 
  3706.  * Return value:
  3707.  *  A valid pointer to an NSSPKIXNumericUserIdentifier upon success
  3708.  *  NULL upon failure
  3709.  */
  3710. NSS_EXTERN NSSPKIXNumericUserIdentifier *
  3711. NSSPKIXNumericUserIdentifier_CreateFromUTF8
  3712. (
  3713.   NSSArena *arenaOpt,
  3714.   NSSUTF8 *utf8
  3715. );
  3716. /*
  3717.  * NSSPKIXNumericUserIdentifier_Encode
  3718.  *
  3719.  *
  3720.  *
  3721.  * The error may be one of the following values:
  3722.  *  NSS_ERROR_INVALID_PKIX_NUMERIC_USER_IDENTIFIER
  3723.  *  NSS_ERROR_NO_MEMORY
  3724.  *
  3725.  * Return value:
  3726.  *  A valid NSSBER pointer upon success
  3727.  *  NULL upon failure
  3728.  */
  3729. NSS_EXTERN NSSBER *
  3730. NSSPKIXNumericUserIdentifier_Encode
  3731. (
  3732.   NSSPKIXNumericUserIdentifier *name,
  3733.   NSSASN1EncodingType encoding,
  3734.   NSSBER *rvOpt,
  3735.   NSSArena *arenaOpt
  3736. );
  3737. /*
  3738.  * PersonalName
  3739.  *
  3740.  * -- fgmr comments --
  3741.  *
  3742.  * From RFC 2459:
  3743.  *
  3744.  *  PersonalName ::= SET {
  3745.  *     surname [0] PrintableString (SIZE (1..ub-surname-length)),
  3746.  *     given-name [1] PrintableString
  3747.  *                          (SIZE (1..ub-given-name-length)) OPTIONAL,
  3748.  *     initials [2] PrintableString (SIZE (1..ub-initials-length)) OPTIONAL,
  3749.  *     generation-qualifier [3] PrintableString
  3750.  *                  (SIZE (1..ub-generation-qualifier-length)) OPTIONAL }
  3751.  *
  3752.  * The public calls for this type:
  3753.  *
  3754.  *  NSSPKIXPersonalName_Decode
  3755.  *  NSSPKIXPersonalName_Create
  3756.  *  NSSPKIXPersonalName_Destroy
  3757.  *  NSSPKIXPersonalName_Encode
  3758.  *  NSSPKIXPersonalName_GetSurname
  3759.  *  NSSPKIXPersonalName_SetSurname
  3760.  *  NSSPKIXPersonalName_HasGivenName
  3761.  *  NSSPKIXPersonalName_GetGivenName
  3762.  *  NSSPKIXPersonalName_SetGivenName
  3763.  *  NSSPKIXPersonalName_RemoveGivenName
  3764.  *  NSSPKIXPersonalName_HasInitials
  3765.  *  NSSPKIXPersonalName_GetInitials
  3766.  *  NSSPKIXPersonalName_SetInitials
  3767.  *  NSSPKIXPersonalName_RemoveInitials
  3768.  *  NSSPKIXPersonalName_HasGenerationQualifier
  3769.  *  NSSPKIXPersonalName_GetGenerationQualifier
  3770.  *  NSSPKIXPersonalName_SetGenerationQualifier
  3771.  *  NSSPKIXPersonalName_RemoveGenerationQualifier
  3772.  *  NSSPKIXPersonalName_Equal
  3773.  *  NSSPKIXPersonalName_Duplicate
  3774.  *
  3775.  */
  3776. /*
  3777.  * NSSPKIXPersonalName_Decode
  3778.  *
  3779.  * -- fgmr comments --
  3780.  *
  3781.  * The error may be one of the following values:
  3782.  *  NSS_ERROR_INVALID_BER
  3783.  *  NSS_ERROR_NO_MEMORY
  3784.  *  NSS_ERROR_INVALID_ARENA
  3785.  *
  3786.  * Return value:
  3787.  *  A valid pointer to an NSSPKIXPersonalName upon success
  3788.  *  NULL upon failure
  3789.  */
  3790. NSS_EXTERN NSSPKIXPersonalName *
  3791. NSSPKIXPersonalName_Decode
  3792. (
  3793.   NSSArena *arenaOpt,
  3794.   NSSBER *ber
  3795. );
  3796. /*
  3797.  * NSSPKIXPersonalName_Create
  3798.  *
  3799.  * -- fgmr comments --
  3800.  *
  3801.  * The error may be one of the following values:
  3802.  *  NSS_ERROR_NO_MEMORY
  3803.  *  NSS_ERROR_INVALID_ARENA
  3804.  *  NSS_ERROR_INVALID_STRING
  3805.  *
  3806.  * Return value:
  3807.  *  A valid pointer to an NSSPKIXPersonalName upon success
  3808.  *  NULL upon failure
  3809.  */
  3810. NSS_EXTERN NSSPKIXPersonalName *
  3811. NSSPKIXPersonalName_Create
  3812. (
  3813.   NSSArena *arenaOpt,
  3814.   NSSUTF8 *surname,
  3815.   NSSUTF8 *givenNameOpt,
  3816.   NSSUTF8 *initialsOpt,
  3817.   NSSUTF8 *generationQualifierOpt
  3818. );
  3819. /*
  3820.  * NSSPKIXPersonalName_Destroy
  3821.  *
  3822.  * -- fgmr comments --
  3823.  *
  3824.  * The error may be one of the following values:
  3825.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  3826.  *
  3827.  * Return value:
  3828.  *  PR_SUCCESS upon success
  3829.  *  PR_FAILURE upon failure
  3830.  */
  3831. NSS_EXTERN PRStatus
  3832. NSSPKIXPersonalName_Destroy
  3833. (
  3834.   NSSPKIXPersonalName *personalName
  3835. );
  3836. /*
  3837.  * NSSPKIXPersonalName_Encode
  3838.  *
  3839.  * -- fgmr comments --
  3840.  *
  3841.  * The error may be one of the following values:
  3842.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  3843.  *  NSS_ERROR_INVALID_ARENA
  3844.  *  NSS_ERROR_NO_MEMORY
  3845.  *
  3846.  * Return value:
  3847.  *  A valid NSSBER pointer upon success
  3848.  *  NULL upon failure
  3849.  */
  3850. NSS_EXTERN NSSBER *
  3851. NSSPKIXPersonalName_Encode
  3852. (
  3853.   NSSPKIXPersonalName *personalName,
  3854.   NSSASN1EncodingType encoding,
  3855.   NSSBER *rvOpt,
  3856.   NSSArena *arenaOpt
  3857. );
  3858. /*
  3859.  * NSSPKIXPersonalName_GetSurname
  3860.  *
  3861.  * -- fgmr comments --
  3862.  *
  3863.  * The error may be one of the following values:
  3864.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  3865.  *  NSS_ERROR_INVALID_ARENA
  3866.  *  NSS_ERROR_NO_MEMORY
  3867.  *
  3868.  * Return value:
  3869.  *  A valid pointer to an NSSUTF8 upon success
  3870.  *  NULL upon failure
  3871.  */
  3872. NSS_EXTERN NSSUTF8 *
  3873. NSSPKIXPersonalName_GetSurname
  3874. (
  3875.   NSSPKIXPersonalName *personalName,
  3876.   NSSArena *arenaOpt
  3877. );
  3878. /*
  3879.  * NSSPKIXPersonalName_SetSurname
  3880.  *
  3881.  * -- fgmr comments --
  3882.  *
  3883.  * The error may be one of the following values:
  3884.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  3885.  *  NSS_ERROR_INVALID_STRING
  3886.  *
  3887.  * Return value:
  3888.  *  PR_SUCCESS upon success
  3889.  *  PR_FAILURE upon failure
  3890.  */
  3891. NSS_EXTERN PRStatus
  3892. NSSPKIXPersonalName_SetSurname
  3893. (
  3894.   NSSPKIXPersonalName *personalName,
  3895.   NSSUTF8 *surname
  3896. );
  3897. /*
  3898.  * NSSPKIXPersonalName_HasGivenName
  3899.  *
  3900.  * -- fgmr comments --
  3901.  *
  3902.  * The error may be one of the following values:
  3903.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  3904.  *
  3905.  * Return value:
  3906.  *  PR_TRUE if it has one
  3907.  *  PR_FALSE if it doesn't
  3908.  *  PR_FALSE upon failure
  3909.  */
  3910. NSS_EXTERN PRBool
  3911. NSSPKIXPersonalName_HasGivenName
  3912. (
  3913.   NSSPKIXPersonalName *personalName,
  3914.   PRStatus *statusOpt
  3915. );
  3916. /*
  3917.  * NSSPKIXPersonalName_GetGivenName
  3918.  *
  3919.  * -- fgmr comments --
  3920.  *
  3921.  * The error may be one of the following values:
  3922.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  3923.  *  NSS_ERROR_INVALID_ARENA
  3924.  *  NSS_ERROR_NO_MEMORY
  3925.  *  NSS_ERROR_HAS_NO_GIVEN_NAME
  3926.  *
  3927.  * Return value:
  3928.  *  A valid pointer to an NSSUTF8 upon success
  3929.  *  NULL upon failure
  3930.  */
  3931. NSS_EXTERN NSSUTF8 *
  3932. NSSPKIXPersonalName_GetGivenName
  3933. (
  3934.   NSSPKIXPersonalName *personalName,
  3935.   NSSArena *arenaOpt
  3936. );
  3937. /*
  3938.  * NSSPKIXPersonalName_SetGivenName
  3939.  *
  3940.  * -- fgmr comments --
  3941.  *
  3942.  * The error may be one of the following values:
  3943.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  3944.  *  NSS_ERROR_INVALID_STRING
  3945.  *
  3946.  * Return value:
  3947.  *  PR_SUCCESS upon success
  3948.  *  PR_FAILURE upon failure
  3949.  */
  3950. NSS_EXTERN PRStatus
  3951. NSSPKIXPersonalName_SetGivenName
  3952. (
  3953.   NSSPKIXPersonalName *personalName,
  3954.   NSSUTF8 *givenName
  3955. );
  3956. /*
  3957.  * NSSPKIXPersonalName_RemoveGivenName
  3958.  *
  3959.  * -- fgmr comments --
  3960.  *
  3961.  * The error may be one of the following values:
  3962.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  3963.  *  NSS_ERROR_HAS_NO_GIVEN_NAME
  3964.  *
  3965.  * Return value:
  3966.  *  PR_SUCCESS upon success
  3967.  *  PR_FAILURE upon failure
  3968.  */
  3969. NSS_EXTERN PRStatus
  3970. NSSPKIXPersonalName_RemoveGivenName
  3971. (
  3972.   NSSPKIXPersonalName *personalName
  3973. );
  3974. /*
  3975.  * NSSPKIXPersonalName_HasInitials
  3976.  *
  3977.  * -- fgmr comments --
  3978.  *
  3979.  * The error may be one of the following values:
  3980.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  3981.  *
  3982.  * Return value:
  3983.  *  PR_TRUE if it has one
  3984.  *  PR_FALSE if it doesn't
  3985.  *  PR_FALSE upon failure
  3986.  */
  3987. NSS_EXTERN PRBool
  3988. NSSPKIXPersonalName_HasInitials
  3989. (
  3990.   NSSPKIXPersonalName *personalName,
  3991.   PRStatus *statusOpt
  3992. );
  3993. /*
  3994.  * NSSPKIXPersonalName_GetInitials
  3995.  *
  3996.  * -- fgmr comments --
  3997.  *
  3998.  * The error may be one of the following values:
  3999.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  4000.  *
  4001.  * Return value:
  4002.  *  A valid pointer to an NSSUTF8 upon success
  4003.  *  NULL upon failure
  4004.  */
  4005. NSS_EXTERN NSSUTF8 *
  4006. NSSPKIXPersonalName_GetInitials
  4007. (
  4008.   NSSPKIXPersonalName *personalName,
  4009.   NSSArena *arenaOpt
  4010. );
  4011. /*
  4012.  * NSSPKIXPersonalName_SetInitials
  4013.  *
  4014.  * -- fgmr comments --
  4015.  *
  4016.  * The error may be one of the following values:
  4017.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  4018.  *  NSS_ERROR_INVALID_STRING
  4019.  *
  4020.  * Return value:
  4021.  *  PR_SUCCESS upon success
  4022.  *  PR_FAILURE upon failure
  4023.  */
  4024. NSS_EXTERN PRStatus
  4025. NSSPKIXPersonalName_SetInitials
  4026. (
  4027.   NSSPKIXPersonalName *personalName,
  4028.   NSSUTF8 *initials
  4029. );
  4030. /*
  4031.  * NSSPKIXPersonalName_RemoveInitials
  4032.  *
  4033.  * -- fgmr comments --
  4034.  *
  4035.  * The error may be one of the following values:
  4036.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  4037.  *
  4038.  * Return value:
  4039.  *  PR_SUCCESS upon success
  4040.  *  PR_FAILURE upon failure
  4041.  */
  4042. NSS_EXTERN PRStatus
  4043. NSSPKIXPersonalName_RemoveInitials
  4044. (
  4045.   NSSPKIXPersonalName *personalName
  4046. );
  4047. /*
  4048.  * NSSPKIXPersonalName_HasGenerationQualifier
  4049.  *
  4050.  * -- fgmr comments --
  4051.  *
  4052.  * The error may be one of the following values:
  4053.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  4054.  *
  4055.  * Return value:
  4056.  *  PR_TRUE if it has one
  4057.  *  PR_FALSE if it doesn't
  4058.  *  PR_FALSE upon failure
  4059.  */
  4060. NSS_EXTERN PRBool
  4061. NSSPKIXPersonalName_HasGenerationQualifier
  4062. (
  4063.   NSSPKIXPersonalName *personalName,
  4064.   PRStatus *statusOpt
  4065. );
  4066. /*
  4067.  * NSSPKIXPersonalName_GetGenerationQualifier
  4068.  *
  4069.  * -- fgmr comments --
  4070.  *
  4071.  * The error may be one of the following values:
  4072.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  4073.  *
  4074.  * Return value:
  4075.  *  A valid pointer to an NSSUTF8 upon success
  4076.  *  NULL upon failure
  4077.  */
  4078. NSS_EXTERN NSSUTF8 *
  4079. NSSPKIXPersonalName_GetGenerationQualifier
  4080. (
  4081.   NSSPKIXPersonalName *personalName,
  4082.   NSSArena *arenaOpt
  4083. );
  4084. /*
  4085.  * NSSPKIXPersonalName_SetGenerationQualifier
  4086.  *
  4087.  * -- fgmr comments --
  4088.  *
  4089.  * The error may be one of the following values:
  4090.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  4091.  *  NSS_ERROR_INVALID_STRING
  4092.  *
  4093.  * Return value:
  4094.  *  PR_SUCCESS upon success
  4095.  *  PR_FAILURE upon failure
  4096.  */
  4097. NSS_EXTERN PRStatus
  4098. NSSPKIXPersonalName_SetGenerationQualifier
  4099. (
  4100.   NSSPKIXPersonalName *personalName,
  4101.   NSSUTF8 *generationQualifier
  4102. );
  4103. /*
  4104.  * NSSPKIXPersonalName_RemoveGenerationQualifier
  4105.  *
  4106.  * -- fgmr comments --
  4107.  *
  4108.  * The error may be one of the following values:
  4109.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  4110.  *
  4111.  * Return value:
  4112.  *  PR_SUCCESS upon success
  4113.  *  PR_FAILURE upon failure
  4114.  */
  4115. NSS_EXTERN PRStatus
  4116. NSSPKIXPersonalName_RemoveGenerationQualifier
  4117. (
  4118.   NSSPKIXPersonalName *personalName
  4119. );
  4120. /*
  4121.  * NSSPKIXPersonalName_Equal
  4122.  *
  4123.  * -- fgmr comments --
  4124.  *
  4125.  * The error may be one of the following values:
  4126.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  4127.  *
  4128.  * Return value:
  4129.  *  PR_TRUE if the two objects have equal values
  4130.  *  PR_FALSE otherwise
  4131.  *  PR_FALSE upon error
  4132.  */
  4133. NSS_EXTERN PRBool
  4134. NSSPKIXPersonalName_Equal
  4135. (
  4136.   NSSPKIXPersonalName *personalName1,
  4137.   NSSPKIXPersonalName *personalName2,
  4138.   PRStatus *statusOpt
  4139. );
  4140. /*
  4141.  * NSSPKIXPersonalName_Duplicate
  4142.  *
  4143.  * -- fgmr comments --
  4144.  *
  4145.  * The error may be one of the following values:
  4146.  *  NSS_ERROR_INVALID_PKIX_PERSONAL_NAME
  4147.  *
  4148.  * Return value:
  4149.  *  A valid pointer to an NSSPKIXPersonalName upon success
  4150.  *  NULL upon failure
  4151.  */
  4152. NSS_EXTERN NSSPKIXPersonalName *
  4153. NSSPKIXPersonalName_Duplicate
  4154. (
  4155.   NSSPKIXPersonalName *personalName,
  4156.   NSSArena *arenaOpt
  4157. );
  4158. /*
  4159.  * OrganizationalUnitNames
  4160.  *
  4161.  * -- fgmr comments --
  4162.  *
  4163.  * From RFC 2459:
  4164.  *
  4165.  *  OrganizationalUnitNames ::= SEQUENCE SIZE (1..ub-organizational-units)
  4166.  *                                          OF OrganizationalUnitName
  4167.  * 
  4168.  * The public calls for the type:
  4169.  *
  4170.  *  NSSPKIXOrganizationalUnitNames_Decode
  4171.  *  NSSPKIXOrganizationalUnitNames_Create
  4172.  *  NSSPKIXOrganizationalUnitNames_Destroy
  4173.  *  NSSPKIXOrganizationalUnitNames_Encode
  4174.  *  NSSPKIXOrganizationalUnitNames_GetOrganizationalUnitNameCount
  4175.  *  NSSPKIXOrganizationalUnitNames_GetOrganizationalUnitNames
  4176.  *  NSSPKIXOrganizationalUnitNames_SetOrganizationalUnitNames
  4177.  *  NSSPKIXOrganizationalUnitNames_GetOrganizationalUnitName
  4178.  *  NSSPKIXOrganizationalUnitNames_SetOrganizationalUnitName
  4179.  *  NSSPKIXOrganizationalUnitNames_InsertOrganizationalUnitName
  4180.  *  NSSPKIXOrganizationalUnitNames_AppendOrganizationalUnitName
  4181.  *  NSSPKIXOrganizationalUnitNames_RemoveOrganizationalUnitName
  4182.  *  NSSPKIXOrganizationalUnitNames_FindOrganizationalUnitName
  4183.  *  NSSPKIXOrganizationalUnitNames_Equal
  4184.  *  NSSPKIXOrganizationalUnitNames_Duplicate
  4185.  *
  4186.  */
  4187. /*
  4188.  * NSSPKIXOrganizationalUnitNames_Decode
  4189.  *
  4190.  * -- fgmr comments --
  4191.  *
  4192.  * The error may be one of the following values:
  4193.  *  NSS_ERROR_INVALID_BER
  4194.  *  NSS_ERROR_NO_MEMORY
  4195.  *  NSS_ERROR_INVALID_ARENA
  4196.  *
  4197.  * Return value:
  4198.  *  A valid pointer to an NSSPKIXOrganizationalUnitNames upon success
  4199.  *  NULL upon failure
  4200.  */
  4201. NSS_EXTERN NSSPKIXOrganizationalUnitNames *
  4202. NSSPKIXOrganizationalUnitNames_Decode
  4203. (
  4204.   NSSArena *arenaOpt,
  4205.   NSSBER *ber
  4206. );
  4207. /*
  4208.  * NSSPKIXOrganizationalUnitNames_Create
  4209.  *
  4210.  * -- fgmr comments --
  4211.  *
  4212.  * The error may be one of the following values:
  4213.  *  NSS_ERROR_NO_MEMORY
  4214.  *  NSS_ERROR_INVALID_ARENA
  4215.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAME
  4216.  *
  4217.  * Return value:
  4218.  *  A valid pointer to an NSSPKIXOrganizationalUnitNames upon success
  4219.  *  NULL upon failure
  4220.  */
  4221. NSS_EXTERN NSSPKIXOrganizationalUnitNames *
  4222. NSSPKIXOrganizationalUnitNames_Create
  4223. (
  4224.   NSSArena *arenaOpt,
  4225.   NSSPKIXOrganizationalUnitName *ou1,
  4226.   ...
  4227. );
  4228. /*
  4229.  * NSSPKIXOrganizationalUnitNames_Destroy
  4230.  *
  4231.  * -- fgmr comments --
  4232.  *
  4233.  * The error may be one of the following values:
  4234.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
  4235.  *
  4236.  * Return value:
  4237.  *  PR_SUCCESS upon success
  4238.  *  PR_FAILURE upon failure
  4239.  */
  4240. NSS_EXTERN PRStatus
  4241. NSSPKIXOrganizationalUnitNames_Destroy
  4242. (
  4243.   NSSPKIXOrganizationalUnitNames *ous
  4244. );
  4245. /*
  4246.  * NSSPKIXOrganizationalUnitNames_Encode
  4247.  *
  4248.  * -- fgmr comments --
  4249.  *
  4250.  * The error may be one of the following values:
  4251.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
  4252.  *  NSS_ERROR_INVALID_ARENA
  4253.  *  NSS_ERROR_NO_MEMORY
  4254.  *
  4255.  * Return value:
  4256.  *  A valid NSSBER pointer upon success
  4257.  *  NULL upon failure
  4258.  */
  4259. NSS_EXTERN NSSBER *
  4260. NSSPKIXOrganizationalUnitNames_Encode
  4261. (
  4262.   NSSPKIXOrganizationalUnitNames *ous,
  4263.   NSSASN1EncodingType encoding,
  4264.   NSSBER *rvOpt,
  4265.   NSSArena *arenaOpt
  4266. );
  4267. /*
  4268.  * NSSPKIXOrganizationalUnitNames_GetOrganizationalUnitNameCount
  4269.  *
  4270.  * -- fgmr comments --
  4271.  *
  4272.  * The error may be one of the following values:
  4273.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
  4274.  *  NSS_ERROR_VALUE_OUT_OF_RANGE
  4275.  *
  4276.  * Return value:
  4277.  *  Nonnegative integer upon success
  4278.  *  -1 upon failure.
  4279.  */
  4280. NSS_EXTERN PRInt32
  4281. NSSPKIXOrganizationalUnitNames_GetOrganizationalUnitNameCount
  4282. (
  4283.   NSSPKIXOrganizationalUnitNames *ous
  4284. );
  4285. /*
  4286.  * NSSPKIXOrganizationalUnitNames_GetOrganizationalUnitNames
  4287.  *
  4288.  * -- fgmr comments --
  4289.  *
  4290.  * The error may be one of the following values:
  4291.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
  4292.  *  NSS_ERROR_INVALID_ARENA
  4293.  *  NSS_ERROR_NO_MEMORY
  4294.  *  NSS_ERROR_ARRAY_TOO_SMALL
  4295.  *
  4296.  * Return value:
  4297.  *  A valid pointer to an array of NSSPKIXOrganizationalUnitName
  4298.  *      pointers upon success
  4299.  *  NULL upon failure
  4300.  */
  4301. NSS_EXTERN NSSPKIXOrganizationalUnitName **
  4302. NSSPKIXOrganizationalUnitNames_GetOrganizationalUnitNames
  4303. (
  4304.   NSSPKIXOrganizationalUnitNames *ous,
  4305.   NSSPKIXOrganizationalUnitName *rvOpt[],
  4306.   PRInt32 limit,
  4307.   NSSArena *arenaOpt
  4308. );
  4309. /*
  4310.  * NSSPKIXOrganizationalUnitNames_SetOrganizationalUnitNames
  4311.  *
  4312.  * -- fgmr comments --
  4313.  *
  4314.  * The error may be one of the following values:
  4315.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
  4316.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAME
  4317.  *  NSS_ERROR_NO_MEMORY
  4318.  *
  4319.  * Return value:
  4320.  *  PR_SUCCESS upon success
  4321.  *  PR_FAILURE upon failure
  4322.  */
  4323. NSS_EXTERN PRStatus
  4324. NSSPKIXOrganizationalUnitNames_SetOrganizationalUnitNames
  4325. (
  4326.   NSSPKIXOrganizationalUnitNames *ous,
  4327.   NSSPKIXOrganizationalUnitName *ou[],
  4328.   PRInt32 count
  4329. );
  4330. /*
  4331.  * NSSPKIXOrganizationalUnitNames_GetOrganizationalUnitName
  4332.  *
  4333.  * -- fgmr comments --
  4334.  *
  4335.  * The error may be one of the following values:
  4336.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
  4337.  *  NSS_ERROR_VALUE_OUT_OF_RANGE
  4338.  *  NSS_ERROR_NO_MEMORY
  4339.  *  NSS_ERROR_INVALID_ARENA
  4340.  *
  4341.  * Return value:
  4342.  *  A valid pointer to an NSSPKIXOrganizationalUnitName upon success
  4343.  *  NULL upon failure
  4344.  */
  4345. NSS_EXTERN NSSPKIXOrganizationalUnitName *
  4346. NSSPKIXOrganizationalUnitNames_GetOrganizationalUnitName
  4347. (
  4348.   NSSPKIXOrganizationalUnitNames *ous,
  4349.   PRInt32 i,
  4350.   NSSArena *arenaOpt
  4351. );
  4352. /*
  4353.  * NSSPKIXOrganizationalUnitNames_SetOrganizationalUnitName
  4354.  *
  4355.  * -- fgmr comments --
  4356.  *
  4357.  * The error may be one of the following values:
  4358.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
  4359.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAME
  4360.  *  NSS_ERROR_VALUE_OUT_OF_RANGE
  4361.  *  NSS_ERROR_NO_MEMORY
  4362.  *
  4363.  * Return value:
  4364.  *  PR_SUCCESS upon success
  4365.  *  PR_FAILURE upon failure
  4366.  */
  4367. NSS_EXTERN PRStatus
  4368. NSSPKIXOrganizationalUnitNames_SetOrganizationalUnitName
  4369. (
  4370.   NSSPKIXOrganizationalUnitNames *ous,
  4371.   PRInt32 i,
  4372.   NSSPKIXOrganizationalUnitName *ou
  4373. );
  4374. /*
  4375.  * NSSPKIXOrganizationalUnitNames_InsertOrganizationalUnitName
  4376.  *
  4377.  * -- fgmr comments --
  4378.  *
  4379.  * The error may be one of the following values:
  4380.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
  4381.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAME
  4382.  *  NSS_ERROR_VALUE_OUT_OF_RANGE
  4383.  *  NSS_ERROR_NO_MEMORY
  4384.  *
  4385.  * Return value:
  4386.  *  PR_SUCCESS upon success
  4387.  *  PR_FAILURE upon failure
  4388.  */
  4389. NSS_EXTERN PRStatus
  4390. NSSPKIXOrganizationalUnitNames_InsertOrganizationalUnitName
  4391. (
  4392.   NSSPKIXOrganizationalUnitNames *ous,
  4393.   PRInt32 i,
  4394.   NSSPKIXOrganizationalUnitName *ou
  4395. );
  4396. /*
  4397.  * NSSPKIXOrganizationalUnitNames_AppendOrganizationalUnitName
  4398.  *
  4399.  * -- fgmr comments --
  4400.  *
  4401.  * The error may be one of the following values:
  4402.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
  4403.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAME
  4404.  *  NSS_ERROR_NO_MEMORY
  4405.  *
  4406.  * Return value:
  4407.  *  PR_SUCCESS upon success
  4408.  *  PR_FAILURE upon failure
  4409.  */
  4410. NSS_EXTERN PRStatus
  4411. NSSPKIXOrganizationalUnitNames_AppendOrganizationalUnitName
  4412. (
  4413.   NSSPKIXOrganizationalUnitNames *ous,
  4414.   NSSPKIXOrganizationalUnitName *ou
  4415. );
  4416. /*
  4417.  * NSSPKIXOrganizationalUnitNames_RemoveOrganizationalUnitName
  4418.  *
  4419.  * -- fgmr comments --
  4420.  *
  4421.  * The error may be one of the following values:
  4422.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
  4423.  *  NSS_ERROR_VALUE_OUT_OF_RANGE
  4424.  *
  4425.  * Return value:
  4426.  *  PR_SUCCESS upon success
  4427.  *  PR_FAILURE upon failure
  4428.  */
  4429. NSS_EXTERN PRStatus
  4430. NSSPKIXOrganizationalUnitNames_RemoveOrganizationalUnitName
  4431. (
  4432.   NSSPKIXOrganizationalUnitNames *ous,
  4433.   PRInt32 i
  4434. );
  4435. /*
  4436.  * NSSPKIXOrganizationalUnitNames_FindOrganizationalUnitName
  4437.  *
  4438.  * -- fgmr comments --
  4439.  *
  4440.  * The error may be one of the following values:
  4441.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAMES
  4442.  *  NSS_ERROR_INVALID_PKIX_ORGANIZATIONAL_UNIT_NAME
  4443.  *
  4444.  * Return value:
  4445.  *  The index of the specified revoked certificate upon success
  4446.  *  -1 upon failure
  4447.  */
  4448. NSS_EXTERN PRIntn
  4449. NSSPKIXOrganizationalUnitNames_FindOrganizationalUnitName
  4450. (
  4451.   NSSPKIXOrganizationalUnitNames *ous,
  4452.   NSSPKIXOrganizationalUnitName *ou
  4453. );
  4454. /*
  4455.  * NSSPKIXOrganizationalUnitNames_Equal
  4456.  *
  4457.  * -- fgmr comments --