OLD | NEW |
1 /* This Source Code Form is subject to the terms of the Mozilla Public | 1 /* This Source Code Form is subject to the terms of the Mozilla Public |
2 * License, v. 2.0. If a copy of the MPL was not distributed with this | 2 * License, v. 2.0. If a copy of the MPL was not distributed with this |
3 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ | 3 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ |
4 /* | 4 /* |
5 * pkix_ekuchecker.h | 5 * pkix_ekuchecker.h |
6 * | 6 * |
7 * User Defined Object Type Extended Key Usage Definition | 7 * User Defined Object Type Extended Key Usage Definition |
8 * | 8 * |
9 */ | 9 */ |
10 | 10 |
(...skipping 11 matching lines...) Expand all Loading... |
22 * | 22 * |
23 * DESCRIPTION: | 23 * DESCRIPTION: |
24 * Create a CertChainChecker with EkuCheckerState and add it into | 24 * Create a CertChainChecker with EkuCheckerState and add it into |
25 * PKIX_ProcessingParams object. | 25 * PKIX_ProcessingParams object. |
26 * | 26 * |
27 * PARAMETERS | 27 * PARAMETERS |
28 * "params" | 28 * "params" |
29 * a PKIX_ProcessingParams links to PKIX_ComCertSelParams where a list of | 29 * a PKIX_ProcessingParams links to PKIX_ComCertSelParams where a list of |
30 * Extended Key Usage OIDs specified by application can be retrieved for | 30 * Extended Key Usage OIDs specified by application can be retrieved for |
31 * verification. | 31 * verification. |
32 * "ekuChecker" | 32 * "ekuChecker" |
33 * Address of created ekuchecker. | 33 * Address of created ekuchecker. |
34 * "plContext" | 34 * "plContext" |
35 * Platform-specific context pointer. | 35 * Platform-specific context pointer. |
36 * | 36 * |
37 * THREAD SAFETY: | 37 * THREAD SAFETY: |
38 * Thread Safe (see Thread Safety Definitions in Programmer's Guide) | 38 * Thread Safe (see Thread Safety Definitions in Programmer's Guide) |
39 * | 39 * |
40 * RETURNS: | 40 * RETURNS: |
41 * Returns NULL if the function succeeds. | 41 * Returns NULL if the function succeeds. |
42 * Returns a UserDefinedModules Error if the function fails in a non-fatal | 42 * Returns a UserDefinedModules Error if the function fails in a non-fatal |
43 * way. | 43 * way. |
44 * Returns a Fatal Error | 44 * Returns a Fatal Error |
45 */ | 45 */ |
46 PKIX_Error * | 46 PKIX_Error *PKIX_EkuChecker_Create(PKIX_ProcessingParams *params, |
47 PKIX_EkuChecker_Create( | 47 PKIX_CertChainChecker **ekuChecker, |
48 PKIX_ProcessingParams *params, | 48 void *plContext); |
49 PKIX_CertChainChecker **ekuChecker, | |
50 void *plContext); | |
51 | 49 |
52 /* | 50 /* |
53 * FUNCTION: PKIX_PL_EkuChecker_GetRequiredEku | 51 * FUNCTION: PKIX_PL_EkuChecker_GetRequiredEku |
54 * | 52 * |
55 * DESCRIPTION: | 53 * DESCRIPTION: |
56 * This function retrieves application specified ExtenedKeyUsage(s) from | 54 * This function retrieves application specified ExtenedKeyUsage(s) from |
57 * ComCertSetparams and converts its OID representations to SECCertUsageEnum. | 55 * ComCertSetparams and converts its OID representations to SECCertUsageEnum. |
58 * The result is stored and returned in bit mask at "pRequiredExtKeyUsage". | 56 * The result is stored and returned in bit mask at "pRequiredExtKeyUsage". |
59 * | 57 * |
60 * PARAMETERS | 58 * PARAMETERS |
61 * "certSelector" | 59 * "certSelector" |
62 * a PKIX_CertSelector links to PKIX_ComCertSelParams where a list of | 60 * a PKIX_CertSelector links to PKIX_ComCertSelParams where a list of |
63 * Extended Key Usage OIDs specified by application can be retrieved for | 61 * Extended Key Usage OIDs specified by application can be retrieved for |
64 * verification. Must be non-NULL. | 62 * verification. Must be non-NULL. |
65 * "pRequiredExtKeyUsage" | 63 * "pRequiredExtKeyUsage" |
66 * Address where the result is returned. Must be non-NULL. | 64 * Address where the result is returned. Must be non-NULL. |
67 * "plContext" | 65 * "plContext" |
68 * Platform-specific context pointer. | 66 * Platform-specific context pointer. |
69 * | 67 * |
70 * THREAD SAFETY: | 68 * THREAD SAFETY: |
71 * Thread Safe (see Thread Safety Definitions in Programmer's Guide) | 69 * Thread Safe (see Thread Safety Definitions in Programmer's Guide) |
72 * | 70 * |
73 * RETURNS: | 71 * RETURNS: |
74 * Returns NULL if the function succeeds. | 72 * Returns NULL if the function succeeds. |
75 * Returns a UserDefinedModules Error if the function fails in a non-fatal | 73 * Returns a UserDefinedModules Error if the function fails in a non-fatal |
76 * way. | 74 * way. |
77 * Returns a Fatal Error | 75 * Returns a Fatal Error |
78 */ | 76 */ |
79 PKIX_Error * | 77 PKIX_Error *pkix_EkuChecker_GetRequiredEku(PKIX_CertSelector *certSelector, |
80 pkix_EkuChecker_GetRequiredEku( | 78 PKIX_UInt32 *pRequiredExtKeyUsage, |
81 PKIX_CertSelector *certSelector, | 79 void *plContext); |
82 PKIX_UInt32 *pRequiredExtKeyUsage, | |
83 void *plContext); | |
84 | 80 |
85 /* see source file for function documentation */ | 81 /* see source file for function documentation */ |
86 PKIX_Error *pkix_EkuChecker_RegisterSelf(void *plContext); | 82 PKIX_Error *pkix_EkuChecker_RegisterSelf(void *plContext); |
87 | 83 |
88 #ifdef __cplusplus | 84 #ifdef __cplusplus |
89 } | 85 } |
90 #endif | 86 #endif |
91 | 87 |
92 #endif /* _PKIX_PL_EKUCHECKER_H */ | 88 #endif /* _PKIX_PL_EKUCHECKER_H */ |
OLD | NEW |