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

CA认证

开发平台:

WINDOWS

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