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 * This file defines functions associated with the PKIX_CertSelector and the | 5 * This file defines functions associated with the PKIX_CertSelector and the |
6 * PKIX_ComCertSelParams types. | 6 * PKIX_ComCertSelParams types. |
7 * | 7 * |
8 */ | 8 */ |
9 | 9 |
10 #ifndef _PKIX_CERTSEL_H | 10 #ifndef _PKIX_CERTSEL_H |
(...skipping 90 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
101 * THREAD SAFETY: | 101 * THREAD SAFETY: |
102 * Thread Safe | 102 * Thread Safe |
103 * | 103 * |
104 * Multiple threads must be able to safely call this function without | 104 * Multiple threads must be able to safely call this function without |
105 * worrying about conflicts, even if they're operating on the same object. | 105 * worrying about conflicts, even if they're operating on the same object. |
106 * RETURNS: | 106 * RETURNS: |
107 * Returns NULL if the function succeeds. | 107 * Returns NULL if the function succeeds. |
108 * Returns a CertSelector Error if the function fails in a non-fatal way. | 108 * Returns a CertSelector Error if the function fails in a non-fatal way. |
109 * Returns a Fatal Error if the function fails in an unrecoverable way. | 109 * Returns a Fatal Error if the function fails in an unrecoverable way. |
110 */ | 110 */ |
111 typedef PKIX_Error * | 111 typedef PKIX_Error *(*PKIX_CertSelector_MatchCallback)( |
112 (*PKIX_CertSelector_MatchCallback)( | 112 PKIX_CertSelector *selector, PKIX_PL_Cert *cert, void *plContext); |
113 PKIX_CertSelector *selector, | |
114 PKIX_PL_Cert *cert, | |
115 void *plContext); | |
116 | 113 |
117 /* | 114 /* |
118 * FUNCTION: PKIX_CertSelector_Create | 115 * FUNCTION: PKIX_CertSelector_Create |
119 * DESCRIPTION: | 116 * DESCRIPTION: |
120 * | 117 * |
121 * Creates a new CertSelector using the Object pointed to by | 118 * Creates a new CertSelector using the Object pointed to by |
122 * "certSelectorContext" (if any) and stores it at "pSelector". As noted | 119 * "certSelectorContext" (if any) and stores it at "pSelector". As noted |
123 * above, by default, the MatchCallback is set to point to the default | 120 * above, by default, the MatchCallback is set to point to the default |
124 * implementation provided by libpkix, which understands how to process | 121 * implementation provided by libpkix, which understands how to process |
125 * ComCertSelParams objects. This is overridden if the MatchCallback pointed | 122 * ComCertSelParams objects. This is overridden if the MatchCallback pointed |
126 * to by "callback" is not NULL, in which case the parameters are specified | 123 * to by "callback" is not NULL, in which case the parameters are specified |
127 * using the certSelectorContext. | 124 * using the certSelectorContext. |
128 * | 125 * |
129 * PARAMETERS: | 126 * PARAMETERS: |
130 * "callback" | 127 * "callback" |
131 * The MatchCallback function to be used. | 128 * The MatchCallback function to be used. |
132 * "certSelectorContext" | 129 * "certSelectorContext" |
133 * Address of Object representing the CertSelector's context (if any). | 130 * Address of Object representing the CertSelector's context (if any). |
134 * "pSelector" | 131 * "pSelector" |
135 * Address where object pointer will be stored. Must be non-NULL. | 132 * Address where object pointer will be stored. Must be non-NULL. |
136 * "plContext" | 133 * "plContext" |
137 * Platform-specific context pointer. | 134 * Platform-specific context pointer. |
138 * THREAD SAFETY: | 135 * THREAD SAFETY: |
139 * Thread Safe (see Thread Safety Definitions in Programmer's Guide) | 136 * Thread Safe (see Thread Safety Definitions in Programmer's Guide) |
140 * RETURNS: | 137 * RETURNS: |
141 * Returns NULL if the function succeeds. | 138 * Returns NULL if the function succeeds. |
142 * Returns a CertSelector Error if the function fails in a non-fatal way. | 139 * Returns a CertSelector Error if the function fails in a non-fatal way. |
143 * Returns a Fatal Error if the function fails in an unrecoverable way. | 140 * Returns a Fatal Error if the function fails in an unrecoverable way. |
144 */ | 141 */ |
145 PKIX_Error * | 142 PKIX_Error *PKIX_CertSelector_Create(PKIX_CertSelector_MatchCallback callback, |
146 PKIX_CertSelector_Create( | 143 PKIX_PL_Object *certSelectorContext, |
147 PKIX_CertSelector_MatchCallback callback, | 144 PKIX_CertSelector **pSelector, |
148 PKIX_PL_Object *certSelectorContext, | 145 void *plContext); |
149 PKIX_CertSelector **pSelector, | |
150 void *plContext); | |
151 | 146 |
152 /* | 147 /* |
153 * FUNCTION: PKIX_CertSelector_GetMatchCallback | 148 * FUNCTION: PKIX_CertSelector_GetMatchCallback |
154 * DESCRIPTION: | 149 * DESCRIPTION: |
155 * | 150 * |
156 * Retrieves a pointer to "selector's" Match callback function and puts it in | 151 * Retrieves a pointer to "selector's" Match callback function and puts it in |
157 * "pCallback". | 152 * "pCallback". |
158 * | 153 * |
159 * PARAMETERS: | 154 * PARAMETERS: |
160 * "selector" | 155 * "selector" |
161 * The CertSelector whose Match callback is desired. Must be non-NULL. | 156 * The CertSelector whose Match callback is desired. Must be non-NULL. |
162 * "pCallback" | 157 * "pCallback" |
163 * Address where Match callback function pointer will be stored. | 158 * Address where Match callback function pointer will be stored. |
164 * Must be non-NULL. | 159 * Must be non-NULL. |
165 * "plContext" | 160 * "plContext" |
166 * Platform-specific context pointer. | 161 * Platform-specific context pointer. |
167 * THREAD SAFETY: | 162 * THREAD SAFETY: |
168 * Thread Safe (see Thread Safety Definitions in Programmer's Guide) | 163 * Thread Safe (see Thread Safety Definitions in Programmer's Guide) |
169 * RETURNS: | 164 * RETURNS: |
170 * Returns NULL if the function succeeds. | 165 * Returns NULL if the function succeeds. |
171 * Returns a CertSelector Error if the function fails in a non-fatal way. | 166 * Returns a CertSelector Error if the function fails in a non-fatal way. |
172 * Returns a Fatal Error if the function fails in an unrecoverable way. | 167 * Returns a Fatal Error if the function fails in an unrecoverable way. |
173 */ | 168 */ |
174 PKIX_Error * | 169 PKIX_Error *PKIX_CertSelector_GetMatchCallback( |
175 PKIX_CertSelector_GetMatchCallback( | 170 PKIX_CertSelector *selector, PKIX_CertSelector_MatchCallback *pCallback, |
176 PKIX_CertSelector *selector, | 171 void *plContext); |
177 PKIX_CertSelector_MatchCallback *pCallback, | |
178 void *plContext); | |
179 | 172 |
180 /* | 173 /* |
181 * FUNCTION: PKIX_CertSelector_GetCertSelectorContext | 174 * FUNCTION: PKIX_CertSelector_GetCertSelectorContext |
182 * DESCRIPTION: | 175 * DESCRIPTION: |
183 * | 176 * |
184 * Retrieves a pointer to a PKIX_PL_Object representing the context (if any) | 177 * Retrieves a pointer to a PKIX_PL_Object representing the context (if any) |
185 * of the CertSelector pointed to by "selector" and stores it at | 178 * of the CertSelector pointed to by "selector" and stores it at |
186 * "pCertSelectorContext". | 179 * "pCertSelectorContext". |
187 * | 180 * |
188 * PARAMETERS: | 181 * PARAMETERS: |
189 * "selector" | 182 * "selector" |
190 * Address of CertSelector whose context is to be stored. | 183 * Address of CertSelector whose context is to be stored. |
191 * Must be non-NULL. | 184 * Must be non-NULL. |
192 * "pCertSelectorContext" | 185 * "pCertSelectorContext" |
193 * Address where object pointer will be stored. Must be non-NULL. | 186 * Address where object pointer will be stored. Must be non-NULL. |
194 * "plContext" | 187 * "plContext" |
195 * Platform-specific context pointer. | 188 * Platform-specific context pointer. |
196 * THREAD SAFETY: | 189 * THREAD SAFETY: |
197 * Thread Safe (see Thread Safety Definitions in Programmer's Guide) | 190 * Thread Safe (see Thread Safety Definitions in Programmer's Guide) |
198 * RETURNS: | 191 * RETURNS: |
199 * Returns NULL if the function succeeds. | 192 * Returns NULL if the function succeeds. |
200 * Returns a CertSelector Error if the function fails in a non-fatal way. | 193 * Returns a CertSelector Error if the function fails in a non-fatal way. |
201 * Returns a Fatal Error if the function fails in an unrecoverable way. | 194 * Returns a Fatal Error if the function fails in an unrecoverable way. |
202 */ | 195 */ |
203 PKIX_Error * | 196 PKIX_Error *PKIX_CertSelector_GetCertSelectorContext( |
204 PKIX_CertSelector_GetCertSelectorContext( | 197 PKIX_CertSelector *selector, PKIX_PL_Object **pCertSelectorContext, |
205 PKIX_CertSelector *selector, | 198 void *plContext); |
206 PKIX_PL_Object **pCertSelectorContext, | |
207 void *plContext); | |
208 | 199 |
209 /* | 200 /* |
210 * FUNCTION: PKIX_CertSelector_GetCommonCertSelectorParams | 201 * FUNCTION: PKIX_CertSelector_GetCommonCertSelectorParams |
211 * DESCRIPTION: | 202 * DESCRIPTION: |
212 * | 203 * |
213 * Retrieves a pointer to the ComCertSelParams object that represent the | 204 * Retrieves a pointer to the ComCertSelParams object that represent the |
214 * common parameters of the CertSelector pointed to by "selector" and stores | 205 * common parameters of the CertSelector pointed to by "selector" and stores |
215 * it at "pCommonCertSelectorParams". If there are no common parameters | 206 * it at "pCommonCertSelectorParams". If there are no common parameters |
216 * stored with the CertSelector, this function stores NULL at | 207 * stored with the CertSelector, this function stores NULL at |
217 * "pCommonCertSelectorParams". | 208 * "pCommonCertSelectorParams". |
218 * | 209 * |
219 * PARAMETERS: | 210 * PARAMETERS: |
220 * "selector" | 211 * "selector" |
221 * Address of CertSelector whose ComCertSelParams object is to be stored. | 212 * Address of CertSelector whose ComCertSelParams object is to be stored. |
222 * Must be non-NULL. | 213 * Must be non-NULL. |
223 * "pCommonCertSelectorParams" | 214 * "pCommonCertSelectorParams" |
224 * Address where object pointer will be stored. Must be non-NULL. | 215 * Address where object pointer will be stored. Must be non-NULL. |
225 * "plContext" | 216 * "plContext" |
226 * Platform-specific context pointer. | 217 * Platform-specific context pointer. |
227 * THREAD SAFETY: | 218 * THREAD SAFETY: |
228 * Conditionally Thread Safe | 219 * Conditionally Thread Safe |
229 * (see Thread Safety Definitions in Programmer's Guide) | 220 * (see Thread Safety Definitions in Programmer's Guide) |
230 * RETURNS: | 221 * RETURNS: |
231 * Returns NULL if the function succeeds. | 222 * Returns NULL if the function succeeds. |
232 * Returns a CertSelector Error if the function fails in a non-fatal way. | 223 * Returns a CertSelector Error if the function fails in a non-fatal way. |
233 * Returns a Fatal Error if the function fails in an unrecoverable way. | 224 * Returns a Fatal Error if the function fails in an unrecoverable way. |
234 */ | 225 */ |
235 PKIX_Error * | 226 PKIX_Error *PKIX_CertSelector_GetCommonCertSelectorParams( |
236 PKIX_CertSelector_GetCommonCertSelectorParams( | 227 PKIX_CertSelector *selector, |
237 PKIX_CertSelector *selector, | 228 PKIX_ComCertSelParams **pCommonCertSelectorParams, void *plContext); |
238 PKIX_ComCertSelParams **pCommonCertSelectorParams, | |
239 void *plContext); | |
240 | 229 |
241 /* | 230 /* |
242 * FUNCTION: PKIX_CertSelector_SetCommonCertSelectorParams | 231 * FUNCTION: PKIX_CertSelector_SetCommonCertSelectorParams |
243 * DESCRIPTION: | 232 * DESCRIPTION: |
244 * | 233 * |
245 * Sets the common parameters for the CertSelector pointed to by "selector" | 234 * Sets the common parameters for the CertSelector pointed to by "selector" |
246 * using the ComCertSelParams object pointed to by "commonCertSelectorParams". | 235 * using the ComCertSelParams object pointed to by "commonCertSelectorParams". |
247 * | 236 * |
248 * PARAMETERS: | 237 * PARAMETERS: |
249 * "selector" | 238 * "selector" |
250 * Address of CertSelector whose common parameters are to be set. | 239 * Address of CertSelector whose common parameters are to be set. |
251 * Must be non-NULL. | 240 * Must be non-NULL. |
252 * "commonCertSelectorParams" | 241 * "commonCertSelectorParams" |
253 * Address of ComCertSelParams object representing the common parameters. | 242 * Address of ComCertSelParams object representing the common parameters. |
254 * "plContext" | 243 * "plContext" |
255 * Platform-specific context pointer. | 244 * Platform-specific context pointer. |
256 * THREAD SAFETY: | 245 * THREAD SAFETY: |
257 * Not Thread Safe - assumes exclusive access to "selector" | 246 * Not Thread Safe - assumes exclusive access to "selector" |
258 * (see Thread Safety Definitions in Programmer's Guide) | 247 * (see Thread Safety Definitions in Programmer's Guide) |
259 * RETURNS: | 248 * RETURNS: |
260 * Returns NULL if the function succeeds. | 249 * Returns NULL if the function succeeds. |
261 * Returns a CertSelector Error if the function fails in a non-fatal way. | 250 * Returns a CertSelector Error if the function fails in a non-fatal way. |
262 * Returns a Fatal Error if the function fails in an unrecoverable way. | 251 * Returns a Fatal Error if the function fails in an unrecoverable way. |
263 */ | 252 */ |
264 PKIX_Error * | 253 PKIX_Error *PKIX_CertSelector_SetCommonCertSelectorParams( |
265 PKIX_CertSelector_SetCommonCertSelectorParams( | 254 PKIX_CertSelector *selector, |
266 PKIX_CertSelector *selector, | 255 PKIX_ComCertSelParams *commonCertSelectorParams, void *plContext); |
267 PKIX_ComCertSelParams *commonCertSelectorParams, | |
268 void *plContext); | |
269 | 256 |
270 /* PKIX_ComCertSelParams | 257 /* PKIX_ComCertSelParams |
271 * | 258 * |
272 * PKIX_ComCertSelParams objects are X.509 parameters commonly used with | 259 * PKIX_ComCertSelParams objects are X.509 parameters commonly used with |
273 * CertSelectors, especially when enforcing constraints on a target | 260 * CertSelectors, especially when enforcing constraints on a target |
274 * certificate or determining which certificates to retrieve from a CertStore. | 261 * certificate or determining which certificates to retrieve from a CertStore. |
275 * ComCertSelParams objects are typically used with those CertSelectors that | 262 * ComCertSelParams objects are typically used with those CertSelectors that |
276 * use the default implementation of MatchCallback, which understands how to | 263 * use the default implementation of MatchCallback, which understands how to |
277 * process ComCertSelParams objects. | 264 * process ComCertSelParams objects. |
278 */ | 265 */ |
279 | 266 |
280 /* | 267 /* |
281 * FUNCTION: PKIX_ComCertSelParams_Create | 268 * FUNCTION: PKIX_ComCertSelParams_Create |
282 * DESCRIPTION: | 269 * DESCRIPTION: |
283 * | 270 * |
284 * Creates a new ComCertSelParams object and stores it at "pParams". | 271 * Creates a new ComCertSelParams object and stores it at "pParams". |
285 * | 272 * |
286 * PARAMETERS: | 273 * PARAMETERS: |
287 * "pParams" | 274 * "pParams" |
288 * Address where object pointer will be stored. Must be non-NULL. | 275 * Address where object pointer will be stored. Must be non-NULL. |
289 * "plContext" | 276 * "plContext" |
290 * Platform-specific context pointer. | 277 * Platform-specific context pointer. |
291 * THREAD SAFETY: | 278 * THREAD SAFETY: |
292 * Thread Safe (see Thread Safety Definitions in Programmer's Guide) | 279 * Thread Safe (see Thread Safety Definitions in Programmer's Guide) |
293 * RETURNS: | 280 * RETURNS: |
294 * Returns NULL if the function succeeds. | 281 * Returns NULL if the function succeeds. |
295 * Returns a CertSelector Error if the function fails in a non-fatal way. | 282 * Returns a CertSelector Error if the function fails in a non-fatal way. |
296 * Returns a Fatal Error if the function fails in an unrecoverable way. | 283 * Returns a Fatal Error if the function fails in an unrecoverable way. |
297 */ | 284 */ |
298 PKIX_Error * | 285 PKIX_Error *PKIX_ComCertSelParams_Create(PKIX_ComCertSelParams **pParams, |
299 PKIX_ComCertSelParams_Create( | 286 void *plContext); |
300 PKIX_ComCertSelParams **pParams, | |
301 void *plContext); | |
302 | 287 |
303 /* | 288 /* |
304 * FUNCTION: PKIX_ComCertSelParams_GetSubjAltNames | 289 * FUNCTION: PKIX_ComCertSelParams_GetSubjAltNames |
305 * DESCRIPTION: | 290 * DESCRIPTION: |
306 * | 291 * |
307 * Retrieves a pointer to the List of GeneralNames (if any) representing the | 292 * Retrieves a pointer to the List of GeneralNames (if any) representing the |
308 * subject alternative names criterion that is set in the ComCertSelParams | 293 * subject alternative names criterion that is set in the ComCertSelParams |
309 * object pointed to by "params" and stores it at "pNames". In order to match | 294 * object pointed to by "params" and stores it at "pNames". In order to match |
310 * against this criterion, a certificate must contain all or at least one of | 295 * against this criterion, a certificate must contain all or at least one of |
311 * the criterion's subject alternative names (depending on the result of | 296 * the criterion's subject alternative names (depending on the result of |
(...skipping 16 matching lines...) Expand all Loading... |
328 * "plContext" | 313 * "plContext" |
329 * Platform-specific context pointer. | 314 * Platform-specific context pointer. |
330 * THREAD SAFETY: | 315 * THREAD SAFETY: |
331 * Conditionally Thread Safe | 316 * Conditionally Thread Safe |
332 * (see Thread Safety Definitions in Programmer's Guide) | 317 * (see Thread Safety Definitions in Programmer's Guide) |
333 * RETURNS: | 318 * RETURNS: |
334 * Returns NULL if the function succeeds. | 319 * Returns NULL if the function succeeds. |
335 * Returns a CertSelector Error if the function fails in a non-fatal way. | 320 * Returns a CertSelector Error if the function fails in a non-fatal way. |
336 * Returns a Fatal Error if the function fails in an unrecoverable way. | 321 * Returns a Fatal Error if the function fails in an unrecoverable way. |
337 */ | 322 */ |
338 PKIX_Error * | 323 PKIX_Error *PKIX_ComCertSelParams_GetSubjAltNames( |
339 PKIX_ComCertSelParams_GetSubjAltNames( | 324 PKIX_ComCertSelParams *params, |
340 PKIX_ComCertSelParams *params, | 325 PKIX_List **pNames, /* list of PKIX_PL_GeneralName */ |
341 PKIX_List **pNames, /* list of PKIX_PL_GeneralName */ | 326 void *plContext); |
342 void *plContext); | |
343 | 327 |
344 /* | 328 /* |
345 * FUNCTION: PKIX_ComCertSelParams_SetSubjAltNames | 329 * FUNCTION: PKIX_ComCertSelParams_SetSubjAltNames |
346 * DESCRIPTION: | 330 * DESCRIPTION: |
347 * | 331 * |
348 * Sets the subject alternative names criterion of the ComCertSelParams object | 332 * Sets the subject alternative names criterion of the ComCertSelParams object |
349 * pointed to by "params" using a List of GeneralNames pointed to by "names". | 333 * pointed to by "params" using a List of GeneralNames pointed to by "names". |
350 * In order to match against this criterion, a certificate must contain all or | 334 * In order to match against this criterion, a certificate must contain all or |
351 * at least one of the criterion's subject alternative names (depending on the | 335 * at least one of the criterion's subject alternative names (depending on the |
352 * result of PKIX_ComCertSelParams_GetMatchAllSubjAltNames). The default | 336 * result of PKIX_ComCertSelParams_GetMatchAllSubjAltNames). The default |
(...skipping 13 matching lines...) Expand all Loading... |
366 * "plContext" | 350 * "plContext" |
367 * Platform-specific context pointer. | 351 * Platform-specific context pointer. |
368 * THREAD SAFETY: | 352 * THREAD SAFETY: |
369 * Not Thread Safe - assumes exclusive access to "params" | 353 * Not Thread Safe - assumes exclusive access to "params" |
370 * (see Thread Safety Definitions in Programmer's Guide) | 354 * (see Thread Safety Definitions in Programmer's Guide) |
371 * RETURNS: | 355 * RETURNS: |
372 * Returns NULL if the function succeeds. | 356 * Returns NULL if the function succeeds. |
373 * Returns a CertSelector Error if the function fails in a non-fatal way. | 357 * Returns a CertSelector Error if the function fails in a non-fatal way. |
374 * Returns a Fatal Error if the function fails in an unrecoverable way. | 358 * Returns a Fatal Error if the function fails in an unrecoverable way. |
375 */ | 359 */ |
376 PKIX_Error * | 360 PKIX_Error *PKIX_ComCertSelParams_SetSubjAltNames( |
377 PKIX_ComCertSelParams_SetSubjAltNames( | 361 PKIX_ComCertSelParams *params, |
378 PKIX_ComCertSelParams *params, | 362 PKIX_List *names, /* list of PKIX_PL_GeneralName */ |
379 PKIX_List *names, /* list of PKIX_PL_GeneralName */ | 363 void *plContext); |
380 void *plContext); | |
381 | 364 |
382 /* | 365 /* |
383 * FUNCTION: PKIX_ComCertSelParams_AddSubjAltName | 366 * FUNCTION: PKIX_ComCertSelParams_AddSubjAltName |
384 * DESCRIPTION: | 367 * DESCRIPTION: |
385 * | 368 * |
386 * Adds to the subject alternative names criterion of the ComCertSelParams | 369 * Adds to the subject alternative names criterion of the ComCertSelParams |
387 * object pointed to by "params" using the GeneralName pointed to by "name". | 370 * object pointed to by "params" using the GeneralName pointed to by "name". |
388 * In order to match against this criterion, a certificate must contain all | 371 * In order to match against this criterion, a certificate must contain all |
389 * or at least one of the criterion's subject alternative names (depending on | 372 * or at least one of the criterion's subject alternative names (depending on |
390 * the result of PKIX_ComCertSelParams_GetMatchAllSubjAltNames). The default | 373 * the result of PKIX_ComCertSelParams_GetMatchAllSubjAltNames). The default |
391 * behavior requires a certificate to contain all of the criterion's subject | 374 * behavior requires a certificate to contain all of the criterion's subject |
392 * alternative names in order to match. | 375 * alternative names in order to match. |
393 * | 376 * |
394 * PARAMETERS: | 377 * PARAMETERS: |
395 * "params" | 378 * "params" |
396 * Address of ComCertSelParams object whose subject alternative names | 379 * Address of ComCertSelParams object whose subject alternative names |
397 * criterion is to be added to. Must be non-NULL. | 380 * criterion is to be added to. Must be non-NULL. |
398 * "name" | 381 * "name" |
399 * Address of GeneralName to be added. | 382 * Address of GeneralName to be added. |
400 * "plContext" | 383 * "plContext" |
401 * Platform-specific context pointer. | 384 * Platform-specific context pointer. |
402 * THREAD SAFETY: | 385 * THREAD SAFETY: |
403 * Not Thread Safe - assumes exclusive access to "params" | 386 * Not Thread Safe - assumes exclusive access to "params" |
404 * (see Thread Safety Definitions in Programmer's Guide) | 387 * (see Thread Safety Definitions in Programmer's Guide) |
405 * RETURNS: | 388 * RETURNS: |
406 * Returns NULL if the function succeeds. | 389 * Returns NULL if the function succeeds. |
407 * Returns a CertSelector Error if the function fails in a non-fatal way. | 390 * Returns a CertSelector Error if the function fails in a non-fatal way. |
408 * Returns a Fatal Error if the function fails in an unrecoverable way. | 391 * Returns a Fatal Error if the function fails in an unrecoverable way. |
409 */ | 392 */ |
410 PKIX_Error * | 393 PKIX_Error *PKIX_ComCertSelParams_AddSubjAltName(PKIX_ComCertSelParams *params, |
411 PKIX_ComCertSelParams_AddSubjAltName( | 394 PKIX_PL_GeneralName *name, |
412 PKIX_ComCertSelParams *params, | 395 void *plContext); |
413 PKIX_PL_GeneralName *name, | |
414 void *plContext); | |
415 | 396 |
416 /* | 397 /* |
417 * FUNCTION: PKIX_ComCertSelParams_GetPathToNames | 398 * FUNCTION: PKIX_ComCertSelParams_GetPathToNames |
418 * DESCRIPTION: | 399 * DESCRIPTION: |
419 * | 400 * |
420 * Retrieves a pointer to the List of GeneralNames (if any) representing the | 401 * Retrieves a pointer to the List of GeneralNames (if any) representing the |
421 * path to names criterion that is set in the ComCertSelParams object pointed | 402 * path to names criterion that is set in the ComCertSelParams object pointed |
422 * to by "params" and stores it at "pNames". In order to match against this | 403 * to by "params" and stores it at "pNames". In order to match against this |
423 * criterion, a certificate must not include name constraints that would | 404 * criterion, a certificate must not include name constraints that would |
424 * prohibit building a path to the criterion's specified names. | 405 * prohibit building a path to the criterion's specified names. |
(...skipping 13 matching lines...) Expand all Loading... |
438 * "plContext" | 419 * "plContext" |
439 * Platform-specific context pointer. | 420 * Platform-specific context pointer. |
440 * THREAD SAFETY: | 421 * THREAD SAFETY: |
441 * Conditionally Thread Safe | 422 * Conditionally Thread Safe |
442 * (see Thread Safety Definitions in Programmer's Guide) | 423 * (see Thread Safety Definitions in Programmer's Guide) |
443 * RETURNS: | 424 * RETURNS: |
444 * Returns NULL if the function succeeds. | 425 * Returns NULL if the function succeeds. |
445 * Returns a CertSelector Error if the function fails in a non-fatal way. | 426 * Returns a CertSelector Error if the function fails in a non-fatal way. |
446 * Returns a Fatal Error if the function fails in an unrecoverable way. | 427 * Returns a Fatal Error if the function fails in an unrecoverable way. |
447 */ | 428 */ |
448 PKIX_Error * | 429 PKIX_Error *PKIX_ComCertSelParams_GetPathToNames( |
449 PKIX_ComCertSelParams_GetPathToNames( | 430 PKIX_ComCertSelParams *params, |
450 PKIX_ComCertSelParams *params, | 431 PKIX_List **pNames, /* list of PKIX_PL_GeneralName */ |
451 PKIX_List **pNames, /* list of PKIX_PL_GeneralName */ | 432 void *plContext); |
452 void *plContext); | |
453 | 433 |
454 /* | 434 /* |
455 * FUNCTION: PKIX_ComCertSelParams_SetPathToNames | 435 * FUNCTION: PKIX_ComCertSelParams_SetPathToNames |
456 * DESCRIPTION: | 436 * DESCRIPTION: |
457 * | 437 * |
458 * Sets the path to names criterion of the ComCertSelParams object pointed to | 438 * Sets the path to names criterion of the ComCertSelParams object pointed to |
459 * by "params" using a List of GeneralNames pointed to by "names". In order to | 439 * by "params" using a List of GeneralNames pointed to by "names". In order to |
460 * match against this criterion, a certificate must not include name | 440 * match against this criterion, a certificate must not include name |
461 * constraints that would prohibit building a path to the criterion's | 441 * constraints that would prohibit building a path to the criterion's |
462 * specified names. | 442 * specified names. |
(...skipping 11 matching lines...) Expand all Loading... |
474 * "plContext" | 454 * "plContext" |
475 * Platform-specific context pointer. | 455 * Platform-specific context pointer. |
476 * THREAD SAFETY: | 456 * THREAD SAFETY: |
477 * Not Thread Safe - assumes exclusive access to "params" | 457 * Not Thread Safe - assumes exclusive access to "params" |
478 * (see Thread Safety Definitions in Programmer's Guide) | 458 * (see Thread Safety Definitions in Programmer's Guide) |
479 * RETURNS: | 459 * RETURNS: |
480 * Returns NULL if the function succeeds. | 460 * Returns NULL if the function succeeds. |
481 * Returns a CertSelector Error if the function fails in a non-fatal way. | 461 * Returns a CertSelector Error if the function fails in a non-fatal way. |
482 * Returns a Fatal Error if the function fails in an unrecoverable way. | 462 * Returns a Fatal Error if the function fails in an unrecoverable way. |
483 */ | 463 */ |
484 PKIX_Error * | 464 PKIX_Error *PKIX_ComCertSelParams_SetPathToNames( |
485 PKIX_ComCertSelParams_SetPathToNames( | 465 PKIX_ComCertSelParams *params, |
486 PKIX_ComCertSelParams *params, | 466 PKIX_List *names, /* list of PKIX_PL_GeneralName */ |
487 PKIX_List *names, /* list of PKIX_PL_GeneralName */ | 467 void *plContext); |
488 void *plContext); | |
489 | 468 |
490 /* | 469 /* |
491 * FUNCTION: PKIX_ComCertSelParams_AddPathToName | 470 * FUNCTION: PKIX_ComCertSelParams_AddPathToName |
492 * DESCRIPTION: | 471 * DESCRIPTION: |
493 * | 472 * |
494 * Adds to the path to names criterion of the ComCertSelParams object pointed | 473 * Adds to the path to names criterion of the ComCertSelParams object pointed |
495 * to by "params" using the GeneralName pointed to by "pathToName". In order | 474 * to by "params" using the GeneralName pointed to by "pathToName". In order |
496 * to match against this criterion, a certificate must not include name | 475 * to match against this criterion, a certificate must not include name |
497 * constraints that would prohibit building a path to the criterion's | 476 * constraints that would prohibit building a path to the criterion's |
498 * specified names. | 477 * specified names. |
499 * | 478 * |
500 * PARAMETERS: | 479 * PARAMETERS: |
501 * "params" | 480 * "params" |
502 * Address of ComCertSelParams object whose path to names criterion is to | 481 * Address of ComCertSelParams object whose path to names criterion is to |
503 * be added to. Must be non-NULL. | 482 * be added to. Must be non-NULL. |
504 * "pathToName" | 483 * "pathToName" |
505 * Address of GeneralName to be added. | 484 * Address of GeneralName to be added. |
506 * "plContext" | 485 * "plContext" |
507 * Platform-specific context pointer. | 486 * Platform-specific context pointer. |
508 * THREAD SAFETY: | 487 * THREAD SAFETY: |
509 * Not Thread Safe - assumes exclusive access to "params" | 488 * Not Thread Safe - assumes exclusive access to "params" |
510 * (see Thread Safety Definitions in Programmer's Guide) | 489 * (see Thread Safety Definitions in Programmer's Guide) |
511 * RETURNS: | 490 * RETURNS: |
512 * Returns NULL if the function succeeds. | 491 * Returns NULL if the function succeeds. |
513 * Returns a CertSelector Error if the function fails in a non-fatal way. | 492 * Returns a CertSelector Error if the function fails in a non-fatal way. |
514 * Returns a Fatal Error if the function fails in an unrecoverable way. | 493 * Returns a Fatal Error if the function fails in an unrecoverable way. |
515 */ | 494 */ |
516 PKIX_Error * | 495 PKIX_Error *PKIX_ComCertSelParams_AddPathToName(PKIX_ComCertSelParams *params, |
517 PKIX_ComCertSelParams_AddPathToName( | 496 PKIX_PL_GeneralName *pathToName, |
518 PKIX_ComCertSelParams *params, | 497 void *plContext); |
519 PKIX_PL_GeneralName *pathToName, | |
520 void *plContext); | |
521 | 498 |
522 /* | 499 /* |
523 * FUNCTION: PKIX_ComCertSelParams_GetAuthorityKeyIdentifier | 500 * FUNCTION: PKIX_ComCertSelParams_GetAuthorityKeyIdentifier |
524 * DESCRIPTION: | 501 * DESCRIPTION: |
525 * | 502 * |
526 * Retrieves a pointer to the ByteArray (if any) representing the authority | 503 * Retrieves a pointer to the ByteArray (if any) representing the authority |
527 * key identifier criterion that is set in the ComCertSelParams object | 504 * key identifier criterion that is set in the ComCertSelParams object |
528 * pointed to by "params" and stores it at "pAuthKeyId". In order to match | 505 * pointed to by "params" and stores it at "pAuthKeyId". In order to match |
529 * against this criterion, a certificate must contain an | 506 * against this criterion, a certificate must contain an |
530 * AuthorityKeyIdentifier extension whose value matches the criterion's | 507 * AuthorityKeyIdentifier extension whose value matches the criterion's |
(...skipping 12 matching lines...) Expand all Loading... |
543 * "plContext" | 520 * "plContext" |
544 * Platform-specific context pointer. | 521 * Platform-specific context pointer. |
545 * THREAD SAFETY: | 522 * THREAD SAFETY: |
546 * Conditionally Thread Safe | 523 * Conditionally Thread Safe |
547 * (see Thread Safety Definitions in Programmer's Guide) | 524 * (see Thread Safety Definitions in Programmer's Guide) |
548 * RETURNS: | 525 * RETURNS: |
549 * Returns NULL if the function succeeds. | 526 * Returns NULL if the function succeeds. |
550 * Returns a CertSelector Error if the function fails in a non-fatal way. | 527 * Returns a CertSelector Error if the function fails in a non-fatal way. |
551 * Returns a Fatal Error if the function fails in an unrecoverable way. | 528 * Returns a Fatal Error if the function fails in an unrecoverable way. |
552 */ | 529 */ |
553 PKIX_Error * | 530 PKIX_Error *PKIX_ComCertSelParams_GetAuthorityKeyIdentifier( |
554 PKIX_ComCertSelParams_GetAuthorityKeyIdentifier( | 531 PKIX_ComCertSelParams *params, PKIX_PL_ByteArray **pAuthKeyId, |
555 PKIX_ComCertSelParams *params, | 532 void *plContext); |
556 PKIX_PL_ByteArray **pAuthKeyId, | |
557 void *plContext); | |
558 | 533 |
559 /* | 534 /* |
560 * FUNCTION: PKIX_ComCertSelParams_SetAuthorityKeyIdentifier | 535 * FUNCTION: PKIX_ComCertSelParams_SetAuthorityKeyIdentifier |
561 * DESCRIPTION: | 536 * DESCRIPTION: |
562 * | 537 * |
563 * Sets the authority key identifier criterion of the ComCertSelParams object | 538 * Sets the authority key identifier criterion of the ComCertSelParams object |
564 * pointed to by "params" to the ByteArray pointed to by "authKeyId". In | 539 * pointed to by "params" to the ByteArray pointed to by "authKeyId". In |
565 * order to match against this criterion, a certificate must contain an | 540 * order to match against this criterion, a certificate must contain an |
566 * AuthorityKeyIdentifier extension whose value matches the criterion's | 541 * AuthorityKeyIdentifier extension whose value matches the criterion's |
567 * authority key identifier value. | 542 * authority key identifier value. |
568 * | 543 * |
569 * PARAMETERS: | 544 * PARAMETERS: |
570 * "params" | 545 * "params" |
571 * Address of ComCertSelParams object whose authority key identifier | 546 * Address of ComCertSelParams object whose authority key identifier |
572 * criterion is to be set. Must be non-NULL. | 547 * criterion is to be set. Must be non-NULL. |
573 * "authKeyId" | 548 * "authKeyId" |
574 * Address of ByteArray used to set the criterion | 549 * Address of ByteArray used to set the criterion |
575 * "plContext" | 550 * "plContext" |
576 * Platform-specific context pointer. | 551 * Platform-specific context pointer. |
577 * THREAD SAFETY: | 552 * THREAD SAFETY: |
578 * Not Thread Safe - assumes exclusive access to "params" | 553 * Not Thread Safe - assumes exclusive access to "params" |
579 * (see Thread Safety Definitions in Programmer's Guide) | 554 * (see Thread Safety Definitions in Programmer's Guide) |
580 * RETURNS: | 555 * RETURNS: |
581 * Returns NULL if the function succeeds. | 556 * Returns NULL if the function succeeds. |
582 * Returns a CertSelector Error if the function fails in a non-fatal way. | 557 * Returns a CertSelector Error if the function fails in a non-fatal way. |
583 * Returns a Fatal Error if the function fails in an unrecoverable way. | 558 * Returns a Fatal Error if the function fails in an unrecoverable way. |
584 */ | 559 */ |
585 PKIX_Error * | 560 PKIX_Error *PKIX_ComCertSelParams_SetAuthorityKeyIdentifier( |
586 PKIX_ComCertSelParams_SetAuthorityKeyIdentifier( | 561 PKIX_ComCertSelParams *params, PKIX_PL_ByteArray *authKeyId, |
587 PKIX_ComCertSelParams *params, | 562 void *plContext); |
588 PKIX_PL_ByteArray *authKeyId, | |
589 void *plContext); | |
590 | 563 |
591 /* | 564 /* |
592 * FUNCTION: PKIX_ComCertSelParams_GetSubjKeyIdentifier | 565 * FUNCTION: PKIX_ComCertSelParams_GetSubjKeyIdentifier |
593 * DESCRIPTION: | 566 * DESCRIPTION: |
594 * | 567 * |
595 * Retrieves a pointer to the ByteArray (if any) representing the subject key | 568 * Retrieves a pointer to the ByteArray (if any) representing the subject key |
596 * identifier criterion that is set in the ComCertSelParams object pointed to | 569 * identifier criterion that is set in the ComCertSelParams object pointed to |
597 * by "params" and stores it at "pSubjKeyId". In order to match against this | 570 * by "params" and stores it at "pSubjKeyId". In order to match against this |
598 * criterion, a certificate must contain a SubjectKeyIdentifier extension | 571 * criterion, a certificate must contain a SubjectKeyIdentifier extension |
599 * whose value matches the criterion's subject key identifier value. | 572 * whose value matches the criterion's subject key identifier value. |
(...skipping 11 matching lines...) Expand all Loading... |
611 * "plContext" | 584 * "plContext" |
612 * Platform-specific context pointer. | 585 * Platform-specific context pointer. |
613 * THREAD SAFETY: | 586 * THREAD SAFETY: |
614 * Conditionally Thread Safe | 587 * Conditionally Thread Safe |
615 * (see Thread Safety Definitions in Programmer's Guide) | 588 * (see Thread Safety Definitions in Programmer's Guide) |
616 * RETURNS: | 589 * RETURNS: |
617 * Returns NULL if the function succeeds. | 590 * Returns NULL if the function succeeds. |
618 * Returns a CertSelector Error if the function fails in a non-fatal way. | 591 * Returns a CertSelector Error if the function fails in a non-fatal way. |
619 * Returns a Fatal Error if the function fails in an unrecoverable way. | 592 * Returns a Fatal Error if the function fails in an unrecoverable way. |
620 */ | 593 */ |
621 PKIX_Error * | 594 PKIX_Error *PKIX_ComCertSelParams_GetSubjKeyIdentifier( |
622 PKIX_ComCertSelParams_GetSubjKeyIdentifier( | 595 PKIX_ComCertSelParams *params, PKIX_PL_ByteArray **pSubjKeyId, |
623 PKIX_ComCertSelParams *params, | 596 void *plContext); |
624 PKIX_PL_ByteArray **pSubjKeyId, | |
625 void *plContext); | |
626 | 597 |
627 /* | 598 /* |
628 * FUNCTION: PKIX_ComCertSelParams_SetSubjKeyIdentifier | 599 * FUNCTION: PKIX_ComCertSelParams_SetSubjKeyIdentifier |
629 * DESCRIPTION: | 600 * DESCRIPTION: |
630 * | 601 * |
631 * Sets the subject key identifier criterion of the ComCertSelParams object | 602 * Sets the subject key identifier criterion of the ComCertSelParams object |
632 * pointed to by "params" using a ByteArray pointed to by "subjKeyId". In | 603 * pointed to by "params" using a ByteArray pointed to by "subjKeyId". In |
633 * order to match against this criterion, a certificate must contain an | 604 * order to match against this criterion, a certificate must contain an |
634 * SubjectKeyIdentifier extension whose value matches the criterion's subject | 605 * SubjectKeyIdentifier extension whose value matches the criterion's subject |
635 * key identifier value. | 606 * key identifier value. |
636 * | 607 * |
637 * PARAMETERS: | 608 * PARAMETERS: |
638 * "params" | 609 * "params" |
639 * Address of ComCertSelParams object whose subject key identifier | 610 * Address of ComCertSelParams object whose subject key identifier |
640 * criterion is to be set. Must be non-NULL. | 611 * criterion is to be set. Must be non-NULL. |
641 * "subjKeyId" | 612 * "subjKeyId" |
642 * Address of ByteArray used to set the criterion | 613 * Address of ByteArray used to set the criterion |
643 * "plContext" | 614 * "plContext" |
644 * Platform-specific context pointer. | 615 * Platform-specific context pointer. |
645 * THREAD SAFETY: | 616 * THREAD SAFETY: |
646 * Not Thread Safe - assumes exclusive access to "params" | 617 * Not Thread Safe - assumes exclusive access to "params" |
647 * (see Thread Safety Definitions in Programmer's Guide) | 618 * (see Thread Safety Definitions in Programmer's Guide) |
648 * RETURNS: | 619 * RETURNS: |
649 * Returns NULL if the function succeeds. | 620 * Returns NULL if the function succeeds. |
650 * Returns a CertSelector Error if the function fails in a non-fatal way. | 621 * Returns a CertSelector Error if the function fails in a non-fatal way. |
651 * Returns a Fatal Error if the function fails in an unrecoverable way. | 622 * Returns a Fatal Error if the function fails in an unrecoverable way. |
652 */ | 623 */ |
653 PKIX_Error * | 624 PKIX_Error *PKIX_ComCertSelParams_SetSubjKeyIdentifier( |
654 PKIX_ComCertSelParams_SetSubjKeyIdentifier( | 625 PKIX_ComCertSelParams *params, PKIX_PL_ByteArray *subKeyId, |
655 PKIX_ComCertSelParams *params, | 626 void *plContext); |
656 PKIX_PL_ByteArray *subKeyId, | |
657 void *plContext); | |
658 | 627 |
659 /* | 628 /* |
660 * FUNCTION: PKIX_ComCertSelParams_GetSubjPubKey | 629 * FUNCTION: PKIX_ComCertSelParams_GetSubjPubKey |
661 * DESCRIPTION: | 630 * DESCRIPTION: |
662 * | 631 * |
663 * Retrieves a pointer to the PublicKey (if any) representing the subject | 632 * Retrieves a pointer to the PublicKey (if any) representing the subject |
664 * public key criterion that is set in the ComCertSelParams object pointed to | 633 * public key criterion that is set in the ComCertSelParams object pointed to |
665 * by "params" and stores it at "pPubKey". In order to match against this | 634 * by "params" and stores it at "pPubKey". In order to match against this |
666 * criterion, a certificate must contain a SubjectPublicKey that matches the | 635 * criterion, a certificate must contain a SubjectPublicKey that matches the |
667 * criterion's public key. | 636 * criterion's public key. |
(...skipping 11 matching lines...) Expand all Loading... |
679 * "plContext" | 648 * "plContext" |
680 * Platform-specific context pointer. | 649 * Platform-specific context pointer. |
681 * THREAD SAFETY: | 650 * THREAD SAFETY: |
682 * Conditionally Thread Safe | 651 * Conditionally Thread Safe |
683 * (see Thread Safety Definitions in Programmer's Guide) | 652 * (see Thread Safety Definitions in Programmer's Guide) |
684 * RETURNS: | 653 * RETURNS: |
685 * Returns NULL if the function succeeds. | 654 * Returns NULL if the function succeeds. |
686 * Returns a CertSelector Error if the function fails in a non-fatal way. | 655 * Returns a CertSelector Error if the function fails in a non-fatal way. |
687 * Returns a Fatal Error if the function fails in an unrecoverable way. | 656 * Returns a Fatal Error if the function fails in an unrecoverable way. |
688 */ | 657 */ |
689 PKIX_Error * | 658 PKIX_Error *PKIX_ComCertSelParams_GetSubjPubKey(PKIX_ComCertSelParams *params, |
690 PKIX_ComCertSelParams_GetSubjPubKey( | 659 PKIX_PL_PublicKey **pPubKey, |
691 PKIX_ComCertSelParams *params, | 660 void *plContext); |
692 PKIX_PL_PublicKey **pPubKey, | |
693 void *plContext); | |
694 | 661 |
695 /* | 662 /* |
696 * FUNCTION: PKIX_ComCertSelParams_SetSubjPubKey | 663 * FUNCTION: PKIX_ComCertSelParams_SetSubjPubKey |
697 * DESCRIPTION: | 664 * DESCRIPTION: |
698 * | 665 * |
699 * Sets the subject public key criterion of the ComCertSelParams object | 666 * Sets the subject public key criterion of the ComCertSelParams object |
700 * pointed to by "params" using a PublicKey pointed to by "pubKey". In order | 667 * pointed to by "params" using a PublicKey pointed to by "pubKey". In order |
701 * to match against this criterion, a certificate must contain a | 668 * to match against this criterion, a certificate must contain a |
702 * SubjectPublicKey that matches the criterion's public key. | 669 * SubjectPublicKey that matches the criterion's public key. |
703 * | 670 * |
704 * PARAMETERS: | 671 * PARAMETERS: |
705 * "params" | 672 * "params" |
706 * Address of ComCertSelParams object whose subject public key | 673 * Address of ComCertSelParams object whose subject public key |
707 * criterion is to be set. Must be non-NULL. | 674 * criterion is to be set. Must be non-NULL. |
708 * "pubKey" | 675 * "pubKey" |
709 * Address of PublicKey used to set the criterion | 676 * Address of PublicKey used to set the criterion |
710 * "plContext" | 677 * "plContext" |
711 * Platform-specific context pointer. | 678 * Platform-specific context pointer. |
712 * THREAD SAFETY: | 679 * THREAD SAFETY: |
713 * Not Thread Safe - assumes exclusive access to "params" | 680 * Not Thread Safe - assumes exclusive access to "params" |
714 * (see Thread Safety Definitions in Programmer's Guide) | 681 * (see Thread Safety Definitions in Programmer's Guide) |
715 * RETURNS: | 682 * RETURNS: |
716 * Returns NULL if the function succeeds. | 683 * Returns NULL if the function succeeds. |
717 * Returns a CertSelector Error if the function fails in a non-fatal way. | 684 * Returns a CertSelector Error if the function fails in a non-fatal way. |
718 * Returns a Fatal Error if the function fails in an unrecoverable way. | 685 * Returns a Fatal Error if the function fails in an unrecoverable way. |
719 */ | 686 */ |
720 PKIX_Error * | 687 PKIX_Error *PKIX_ComCertSelParams_SetSubjPubKey(PKIX_ComCertSelParams *params, |
721 PKIX_ComCertSelParams_SetSubjPubKey( | 688 PKIX_PL_PublicKey *pubKey, |
722 PKIX_ComCertSelParams *params, | 689 void *plContext); |
723 PKIX_PL_PublicKey *pubKey, | |
724 void *plContext); | |
725 | 690 |
726 /* | 691 /* |
727 * FUNCTION: PKIX_ComCertSelParams_GetSubjPKAlgId | 692 * FUNCTION: PKIX_ComCertSelParams_GetSubjPKAlgId |
728 * DESCRIPTION: | 693 * DESCRIPTION: |
729 * | 694 * |
730 * Retrieves a pointer to the OID (if any) representing the subject public key | 695 * Retrieves a pointer to the OID (if any) representing the subject public key |
731 * algorithm identifier criterion that is set in the ComCertSelParams object | 696 * algorithm identifier criterion that is set in the ComCertSelParams object |
732 * pointed to by "params" and stores it at "pPubKey". In order to match | 697 * pointed to by "params" and stores it at "pPubKey". In order to match |
733 * against this criterion, a certificate must contain a SubjectPublicKey with | 698 * against this criterion, a certificate must contain a SubjectPublicKey with |
734 * an algorithm that matches the criterion's algorithm. | 699 * an algorithm that matches the criterion's algorithm. |
(...skipping 11 matching lines...) Expand all Loading... |
746 * "plContext" | 711 * "plContext" |
747 * Platform-specific context pointer. | 712 * Platform-specific context pointer. |
748 * THREAD SAFETY: | 713 * THREAD SAFETY: |
749 * Conditionally Thread Safe | 714 * Conditionally Thread Safe |
750 * (see Thread Safety Definitions in Programmer's Guide) | 715 * (see Thread Safety Definitions in Programmer's Guide) |
751 * RETURNS: | 716 * RETURNS: |
752 * Returns NULL if the function succeeds. | 717 * Returns NULL if the function succeeds. |
753 * Returns a CertSelector Error if the function fails in a non-fatal way. | 718 * Returns a CertSelector Error if the function fails in a non-fatal way. |
754 * Returns a Fatal Error if the function fails in an unrecoverable way. | 719 * Returns a Fatal Error if the function fails in an unrecoverable way. |
755 */ | 720 */ |
756 PKIX_Error * | 721 PKIX_Error *PKIX_ComCertSelParams_GetSubjPKAlgId(PKIX_ComCertSelParams *params, |
757 PKIX_ComCertSelParams_GetSubjPKAlgId( | 722 PKIX_PL_OID **pAlgId, |
758 PKIX_ComCertSelParams *params, | 723 void *plContext); |
759 PKIX_PL_OID **pAlgId, | |
760 void *plContext); | |
761 | 724 |
762 /* | 725 /* |
763 * FUNCTION: PKIX_ComCertSelParams_SetSubjPKAlgId | 726 * FUNCTION: PKIX_ComCertSelParams_SetSubjPKAlgId |
764 * DESCRIPTION: | 727 * DESCRIPTION: |
765 * | 728 * |
766 * Sets the subject public key algorithm identifier criterion of the | 729 * Sets the subject public key algorithm identifier criterion of the |
767 * ComCertSelParams object pointed to by "params" using an OID pointed to by | 730 * ComCertSelParams object pointed to by "params" using an OID pointed to by |
768 * "algId". In order to match against this criterion, a certificate must | 731 * "algId". In order to match against this criterion, a certificate must |
769 * contain a SubjectPublicKey with an algorithm that matches the criterion's | 732 * contain a SubjectPublicKey with an algorithm that matches the criterion's |
770 * algorithm. | 733 * algorithm. |
(...skipping 11 matching lines...) Expand all Loading... |
782 * "plContext" | 745 * "plContext" |
783 * Platform-specific context pointer. | 746 * Platform-specific context pointer. |
784 * THREAD SAFETY: | 747 * THREAD SAFETY: |
785 * Not Thread Safe - assumes exclusive access to "params" | 748 * Not Thread Safe - assumes exclusive access to "params" |
786 * (see Thread Safety Definitions in Programmer's Guide) | 749 * (see Thread Safety Definitions in Programmer's Guide) |
787 * RETURNS: | 750 * RETURNS: |
788 * Returns NULL if the function succeeds. | 751 * Returns NULL if the function succeeds. |
789 * Returns a CertSelector Error if the function fails in a non-fatal way. | 752 * Returns a CertSelector Error if the function fails in a non-fatal way. |
790 * Returns a Fatal Error if the function fails in an unrecoverable way. | 753 * Returns a Fatal Error if the function fails in an unrecoverable way. |
791 */ | 754 */ |
792 PKIX_Error * | 755 PKIX_Error *PKIX_ComCertSelParams_SetSubjPKAlgId(PKIX_ComCertSelParams *params, |
793 PKIX_ComCertSelParams_SetSubjPKAlgId( | 756 PKIX_PL_OID *algId, |
794 PKIX_ComCertSelParams *params, | 757 void *plContext); |
795 PKIX_PL_OID *algId, | |
796 void *plContext); | |
797 | 758 |
798 /* | 759 /* |
799 * FUNCTION: PKIX_ComCertSelParams_GetBasicConstraints | 760 * FUNCTION: PKIX_ComCertSelParams_GetBasicConstraints |
800 * DESCRIPTION: | 761 * DESCRIPTION: |
801 * | 762 * |
802 * Retrieves a pointer to the minimum path length (if any) representing the | 763 * Retrieves a pointer to the minimum path length (if any) representing the |
803 * basic constraints criterion that is set in the ComCertSelParams object | 764 * basic constraints criterion that is set in the ComCertSelParams object |
804 * pointed to by "params" and stores it at "pMinPathLength". In order to | 765 * pointed to by "params" and stores it at "pMinPathLength". In order to |
805 * match against this criterion, there are several possibilities. | 766 * match against this criterion, there are several possibilities. |
806 * | 767 * |
(...skipping 23 matching lines...) Expand all Loading... |
830 * "plContext" | 791 * "plContext" |
831 * Platform-specific context pointer. | 792 * Platform-specific context pointer. |
832 * THREAD SAFETY: | 793 * THREAD SAFETY: |
833 * Conditionally Thread Safe | 794 * Conditionally Thread Safe |
834 * (see Thread Safety Definitions in Programmer's Guide) | 795 * (see Thread Safety Definitions in Programmer's Guide) |
835 * RETURNS: | 796 * RETURNS: |
836 * Returns NULL if the function succeeds. | 797 * Returns NULL if the function succeeds. |
837 * Returns a CertSelector Error if the function fails in a non-fatal way. | 798 * Returns a CertSelector Error if the function fails in a non-fatal way. |
838 * Returns a Fatal Error if the function fails in an unrecoverable way. | 799 * Returns a Fatal Error if the function fails in an unrecoverable way. |
839 */ | 800 */ |
840 PKIX_Error * | 801 PKIX_Error *PKIX_ComCertSelParams_GetBasicConstraints( |
841 PKIX_ComCertSelParams_GetBasicConstraints( | 802 PKIX_ComCertSelParams *params, PKIX_Int32 *pMinPathLength, void *plContext); |
842 PKIX_ComCertSelParams *params, | |
843 PKIX_Int32 *pMinPathLength, | |
844 void *plContext); | |
845 | 803 |
846 /* | 804 /* |
847 * FUNCTION: PKIX_ComCertSelParams_SetBasicConstraints | 805 * FUNCTION: PKIX_ComCertSelParams_SetBasicConstraints |
848 * DESCRIPTION: | 806 * DESCRIPTION: |
849 * | 807 * |
850 * Sets the basic constraints criterion of the ComCertSelParams object | 808 * Sets the basic constraints criterion of the ComCertSelParams object |
851 * pointed to by "params" using the integer value of "minPathLength". In | 809 * pointed to by "params" using the integer value of "minPathLength". In |
852 * order to match against this criterion, there are several possibilities. | 810 * order to match against this criterion, there are several possibilities. |
853 * | 811 * |
854 * 1) If the criterion's minimum path length is greater than or equal to zero, | 812 * 1) If the criterion's minimum path length is greater than or equal to zero, |
(...skipping 19 matching lines...) Expand all Loading... |
874 * "plContext" | 832 * "plContext" |
875 * Platform-specific context pointer. | 833 * Platform-specific context pointer. |
876 * THREAD SAFETY: | 834 * THREAD SAFETY: |
877 * Not Thread Safe - assumes exclusive access to "params" | 835 * Not Thread Safe - assumes exclusive access to "params" |
878 * (see Thread Safety Definitions in Programmer's Guide) | 836 * (see Thread Safety Definitions in Programmer's Guide) |
879 * RETURNS: | 837 * RETURNS: |
880 * Returns NULL if the function succeeds. | 838 * Returns NULL if the function succeeds. |
881 * Returns a CertSelector Error if the function fails in a non-fatal way. | 839 * Returns a CertSelector Error if the function fails in a non-fatal way. |
882 * Returns a Fatal Error if the function fails in an unrecoverable way. | 840 * Returns a Fatal Error if the function fails in an unrecoverable way. |
883 */ | 841 */ |
884 PKIX_Error * | 842 PKIX_Error *PKIX_ComCertSelParams_SetBasicConstraints( |
885 PKIX_ComCertSelParams_SetBasicConstraints( | 843 PKIX_ComCertSelParams *params, PKIX_Int32 minPathLength, void *plContext); |
886 PKIX_ComCertSelParams *params, | |
887 PKIX_Int32 minPathLength, | |
888 void *plContext); | |
889 | 844 |
890 /* | 845 /* |
891 * FUNCTION: PKIX_ComCertSelParams_GetCertificate | 846 * FUNCTION: PKIX_ComCertSelParams_GetCertificate |
892 * DESCRIPTION: | 847 * DESCRIPTION: |
893 * | 848 * |
894 * Retrieves a pointer to the Cert (if any) representing the certificate | 849 * Retrieves a pointer to the Cert (if any) representing the certificate |
895 * criterion that is set in the ComCertSelParams object pointed to by | 850 * criterion that is set in the ComCertSelParams object pointed to by |
896 * "params" and stores it at "pCert". In order to match against this | 851 * "params" and stores it at "pCert". In order to match against this |
897 * criterion, a certificate must be equal to the criterion's certificate. If | 852 * criterion, a certificate must be equal to the criterion's certificate. If |
898 * this criterion is specified, it is usually not necessary to specify any | 853 * this criterion is specified, it is usually not necessary to specify any |
(...skipping 12 matching lines...) Expand all Loading... |
911 * "plContext" | 866 * "plContext" |
912 * Platform-specific context pointer. | 867 * Platform-specific context pointer. |
913 * THREAD SAFETY: | 868 * THREAD SAFETY: |
914 * Conditionally Thread Safe | 869 * Conditionally Thread Safe |
915 * (see Thread Safety Definitions in Programmer's Guide) | 870 * (see Thread Safety Definitions in Programmer's Guide) |
916 * RETURNS: | 871 * RETURNS: |
917 * Returns NULL if the function succeeds. | 872 * Returns NULL if the function succeeds. |
918 * Returns a CertSelector Error if the function fails in a non-fatal way. | 873 * Returns a CertSelector Error if the function fails in a non-fatal way. |
919 * Returns a Fatal Error if the function fails in an unrecoverable way. | 874 * Returns a Fatal Error if the function fails in an unrecoverable way. |
920 */ | 875 */ |
921 PKIX_Error * | 876 PKIX_Error *PKIX_ComCertSelParams_GetCertificate(PKIX_ComCertSelParams *params, |
922 PKIX_ComCertSelParams_GetCertificate( | 877 PKIX_PL_Cert **pCert, |
923 PKIX_ComCertSelParams *params, | 878 void *plContext); |
924 PKIX_PL_Cert **pCert, | |
925 void *plContext); | |
926 | 879 |
927 /* | 880 /* |
928 * FUNCTION: PKIX_ComCertSelParams_SetCertificate | 881 * FUNCTION: PKIX_ComCertSelParams_SetCertificate |
929 * DESCRIPTION: | 882 * DESCRIPTION: |
930 * | 883 * |
931 * Sets the certificate criterion of the ComCertSelParams object pointed to by | 884 * Sets the certificate criterion of the ComCertSelParams object pointed to by |
932 * "params" using a Cert pointed to by "cert". In order to match against this | 885 * "params" using a Cert pointed to by "cert". In order to match against this |
933 * criterion, a certificate must be equal to the criterion's certificate. | 886 * criterion, a certificate must be equal to the criterion's certificate. |
934 * If this criterion is specified, it is usually not necessary to specify | 887 * If this criterion is specified, it is usually not necessary to specify |
935 * any other criteria, since this criterion requires an exact certificate | 888 * any other criteria, since this criterion requires an exact certificate |
(...skipping 11 matching lines...) Expand all Loading... |
947 * "plContext" | 900 * "plContext" |
948 * Platform-specific context pointer. | 901 * Platform-specific context pointer. |
949 * THREAD SAFETY: | 902 * THREAD SAFETY: |
950 * Not Thread Safe - assumes exclusive access to "params" | 903 * Not Thread Safe - assumes exclusive access to "params" |
951 * (see Thread Safety Definitions in Programmer's Guide) | 904 * (see Thread Safety Definitions in Programmer's Guide) |
952 * RETURNS: | 905 * RETURNS: |
953 * Returns NULL if the function succeeds. | 906 * Returns NULL if the function succeeds. |
954 * Returns a CertSelector Error if the function fails in a non-fatal way. | 907 * Returns a CertSelector Error if the function fails in a non-fatal way. |
955 * Returns a Fatal Error if the function fails in an unrecoverable way. | 908 * Returns a Fatal Error if the function fails in an unrecoverable way. |
956 */ | 909 */ |
957 PKIX_Error * | 910 PKIX_Error *PKIX_ComCertSelParams_SetCertificate(PKIX_ComCertSelParams *params, |
958 PKIX_ComCertSelParams_SetCertificate( | 911 PKIX_PL_Cert *cert, |
959 PKIX_ComCertSelParams *params, | 912 void *plContext); |
960 PKIX_PL_Cert *cert, | |
961 void *plContext); | |
962 | 913 |
963 /* | 914 /* |
964 * FUNCTION: PKIX_ComCertSelParams_GetCertificateValid | 915 * FUNCTION: PKIX_ComCertSelParams_GetCertificateValid |
965 * DESCRIPTION: | 916 * DESCRIPTION: |
966 * | 917 * |
967 * Retrieves a pointer to the Date (if any) representing the certificate | 918 * Retrieves a pointer to the Date (if any) representing the certificate |
968 * validity criterion that is set in the ComCertSelParams object pointed to by | 919 * validity criterion that is set in the ComCertSelParams object pointed to by |
969 * "params" and stores it at "pDate". In order to match against this | 920 * "params" and stores it at "pDate". In order to match against this |
970 * criterion, a certificate's validity period must include the criterion's | 921 * criterion, a certificate's validity period must include the criterion's |
971 * Date. | 922 * Date. |
(...skipping 11 matching lines...) Expand all Loading... |
983 * "plContext" | 934 * "plContext" |
984 * Platform-specific context pointer. | 935 * Platform-specific context pointer. |
985 * THREAD SAFETY: | 936 * THREAD SAFETY: |
986 * Conditionally Thread Safe | 937 * Conditionally Thread Safe |
987 * (see Thread Safety Definitions in Programmer's Guide) | 938 * (see Thread Safety Definitions in Programmer's Guide) |
988 * RETURNS: | 939 * RETURNS: |
989 * Returns NULL if the function succeeds. | 940 * Returns NULL if the function succeeds. |
990 * Returns a CertSelector Error if the function fails in a non-fatal way. | 941 * Returns a CertSelector Error if the function fails in a non-fatal way. |
991 * Returns a Fatal Error if the function fails in an unrecoverable way. | 942 * Returns a Fatal Error if the function fails in an unrecoverable way. |
992 */ | 943 */ |
993 PKIX_Error * | 944 PKIX_Error *PKIX_ComCertSelParams_GetCertificateValid( |
994 PKIX_ComCertSelParams_GetCertificateValid( | 945 PKIX_ComCertSelParams *params, PKIX_PL_Date **pDate, void *plContext); |
995 PKIX_ComCertSelParams *params, | |
996 PKIX_PL_Date **pDate, | |
997 void *plContext); | |
998 | 946 |
999 /* | 947 /* |
1000 * FUNCTION: PKIX_ComCertSelParams_SetCertificateValid | 948 * FUNCTION: PKIX_ComCertSelParams_SetCertificateValid |
1001 * DESCRIPTION: | 949 * DESCRIPTION: |
1002 * | 950 * |
1003 * Sets the certificate validity criterion of the ComCertSelParams object | 951 * Sets the certificate validity criterion of the ComCertSelParams object |
1004 * pointed to by "params" using a Date pointed to by "date". In order to | 952 * pointed to by "params" using a Date pointed to by "date". In order to |
1005 * match against this criterion, a certificate's validity period must include | 953 * match against this criterion, a certificate's validity period must include |
1006 * the criterion's Date. | 954 * the criterion's Date. |
1007 * | 955 * |
1008 * If "date" is NULL, all certificates are considered to match this criterion. | 956 * If "date" is NULL, all certificates are considered to match this criterion. |
1009 * | 957 * |
1010 * PARAMETERS: | 958 * PARAMETERS: |
1011 * "params" | 959 * "params" |
1012 * Address of ComCertSelParams object whose certificate validity criterion | 960 * Address of ComCertSelParams object whose certificate validity criterion |
1013 * is to be set. Must be non-NULL. | 961 * is to be set. Must be non-NULL. |
1014 * "date" | 962 * "date" |
1015 * Address of Date used to set the criterion | 963 * Address of Date used to set the criterion |
1016 * (or NULL to disable the criterion). | 964 * (or NULL to disable the criterion). |
1017 * "plContext" | 965 * "plContext" |
1018 * Platform-specific context pointer. | 966 * Platform-specific context pointer. |
1019 * THREAD SAFETY: | 967 * THREAD SAFETY: |
1020 * Not Thread Safe - assumes exclusive access to "params" | 968 * Not Thread Safe - assumes exclusive access to "params" |
1021 * (see Thread Safety Definitions in Programmer's Guide) | 969 * (see Thread Safety Definitions in Programmer's Guide) |
1022 * RETURNS: | 970 * RETURNS: |
1023 * Returns NULL if the function succeeds. | 971 * Returns NULL if the function succeeds. |
1024 * Returns a CertSelector Error if the function fails in a non-fatal way. | 972 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1025 * Returns a Fatal Error if the function fails in an unrecoverable way. | 973 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1026 */ | 974 */ |
1027 PKIX_Error * | 975 PKIX_Error *PKIX_ComCertSelParams_SetCertificateValid( |
1028 PKIX_ComCertSelParams_SetCertificateValid( | 976 PKIX_ComCertSelParams *params, PKIX_PL_Date *date, void *plContext); |
1029 PKIX_ComCertSelParams *params, | |
1030 PKIX_PL_Date *date, | |
1031 void *plContext); | |
1032 | 977 |
1033 /* | 978 /* |
1034 * FUNCTION: PKIX_ComCertSelParams_GetSerialNumber | 979 * FUNCTION: PKIX_ComCertSelParams_GetSerialNumber |
1035 * DESCRIPTION: | 980 * DESCRIPTION: |
1036 * | 981 * |
1037 * Retrieves a pointer to the BigInt (if any) representing the serial number | 982 * Retrieves a pointer to the BigInt (if any) representing the serial number |
1038 * criterion that is set in the ComCertSelParams object pointed to by | 983 * criterion that is set in the ComCertSelParams object pointed to by |
1039 * "params" and stores it at "pSerialNumber". In order to match against this | 984 * "params" and stores it at "pSerialNumber". In order to match against this |
1040 * criterion, a certificate must have a serial number equal to the | 985 * criterion, a certificate must have a serial number equal to the |
1041 * criterion's serial number. | 986 * criterion's serial number. |
(...skipping 11 matching lines...) Expand all Loading... |
1053 * "plContext" | 998 * "plContext" |
1054 * Platform-specific context pointer. | 999 * Platform-specific context pointer. |
1055 * THREAD SAFETY: | 1000 * THREAD SAFETY: |
1056 * Conditionally Thread Safe | 1001 * Conditionally Thread Safe |
1057 * (see Thread Safety Definitions in Programmer's Guide) | 1002 * (see Thread Safety Definitions in Programmer's Guide) |
1058 * RETURNS: | 1003 * RETURNS: |
1059 * Returns NULL if the function succeeds. | 1004 * Returns NULL if the function succeeds. |
1060 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1005 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1061 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1006 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1062 */ | 1007 */ |
1063 PKIX_Error * | 1008 PKIX_Error *PKIX_ComCertSelParams_GetSerialNumber( |
1064 PKIX_ComCertSelParams_GetSerialNumber( | 1009 PKIX_ComCertSelParams *params, PKIX_PL_BigInt **pSerialNumber, |
1065 PKIX_ComCertSelParams *params, | 1010 void *plContext); |
1066 PKIX_PL_BigInt **pSerialNumber, | |
1067 void *plContext); | |
1068 | 1011 |
1069 /* | 1012 /* |
1070 * FUNCTION: PKIX_ComCertSelParams_SetSerialNumber | 1013 * FUNCTION: PKIX_ComCertSelParams_SetSerialNumber |
1071 * DESCRIPTION: | 1014 * DESCRIPTION: |
1072 * | 1015 * |
1073 * Sets the serial number criterion of the ComCertSelParams object pointed to | 1016 * Sets the serial number criterion of the ComCertSelParams object pointed to |
1074 * by "params" using a BigInt pointed to by "serialNumber". In order to match | 1017 * by "params" using a BigInt pointed to by "serialNumber". In order to match |
1075 * against this criterion, a certificate must have a serial number equal to | 1018 * against this criterion, a certificate must have a serial number equal to |
1076 * the criterion's serial number. | 1019 * the criterion's serial number. |
1077 * | 1020 * |
(...skipping 10 matching lines...) Expand all Loading... |
1088 * "plContext" | 1031 * "plContext" |
1089 * Platform-specific context pointer. | 1032 * Platform-specific context pointer. |
1090 * THREAD SAFETY: | 1033 * THREAD SAFETY: |
1091 * Not Thread Safe - assumes exclusive access to "params" | 1034 * Not Thread Safe - assumes exclusive access to "params" |
1092 * (see Thread Safety Definitions in Programmer's Guide) | 1035 * (see Thread Safety Definitions in Programmer's Guide) |
1093 * RETURNS: | 1036 * RETURNS: |
1094 * Returns NULL if the function succeeds. | 1037 * Returns NULL if the function succeeds. |
1095 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1038 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1096 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1039 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1097 */ | 1040 */ |
1098 PKIX_Error * | 1041 PKIX_Error *PKIX_ComCertSelParams_SetSerialNumber(PKIX_ComCertSelParams *params, |
1099 PKIX_ComCertSelParams_SetSerialNumber( | 1042 PKIX_PL_BigInt *serialNumber, |
1100 PKIX_ComCertSelParams *params, | 1043 void *plContext); |
1101 PKIX_PL_BigInt *serialNumber, | |
1102 void *plContext); | |
1103 | 1044 |
1104 /* | 1045 /* |
1105 * FUNCTION: PKIX_ComCertSelParams_GetVersion | 1046 * FUNCTION: PKIX_ComCertSelParams_GetVersion |
1106 * DESCRIPTION: | 1047 * DESCRIPTION: |
1107 * | 1048 * |
1108 * Retrieves a PKIX_UInt32 (if any) representing the version criterion that is | 1049 * Retrieves a PKIX_UInt32 (if any) representing the version criterion that is |
1109 * set in the ComCertSelParams object pointed to by "params" and stores it at | 1050 * set in the ComCertSelParams object pointed to by "params" and stores it at |
1110 * "pVersion". In order to match against this criterion, a certificate's | 1051 * "pVersion". In order to match against this criterion, a certificate's |
1111 * version must be equal to the criterion's version. | 1052 * version must be equal to the criterion's version. |
1112 * | 1053 * |
(...skipping 13 matching lines...) Expand all Loading... |
1126 * "plContext" | 1067 * "plContext" |
1127 * Platform-specific context pointer. | 1068 * Platform-specific context pointer. |
1128 * THREAD SAFETY: | 1069 * THREAD SAFETY: |
1129 * Conditionally Thread Safe | 1070 * Conditionally Thread Safe |
1130 * (see Thread Safety Definitions in Programmer's Guide) | 1071 * (see Thread Safety Definitions in Programmer's Guide) |
1131 * RETURNS: | 1072 * RETURNS: |
1132 * Returns NULL if the function succeeds. | 1073 * Returns NULL if the function succeeds. |
1133 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1074 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1134 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1075 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1135 */ | 1076 */ |
1136 PKIX_Error * | 1077 PKIX_Error *PKIX_ComCertSelParams_GetVersion(PKIX_ComCertSelParams *params, |
1137 PKIX_ComCertSelParams_GetVersion( | 1078 PKIX_UInt32 *pVersion, |
1138 PKIX_ComCertSelParams *params, | 1079 void *plContext); |
1139 PKIX_UInt32 *pVersion, | |
1140 void *plContext); | |
1141 | 1080 |
1142 /* | 1081 /* |
1143 * FUNCTION: PKIX_ComCertSelParams_SetVersion | 1082 * FUNCTION: PKIX_ComCertSelParams_SetVersion |
1144 * DESCRIPTION: | 1083 * DESCRIPTION: |
1145 * | 1084 * |
1146 * Sets the version criterion of the ComCertSelParams object pointed to by | 1085 * Sets the version criterion of the ComCertSelParams object pointed to by |
1147 * "params" using the integer value of "version". In order to match against | 1086 * "params" using the integer value of "version". In order to match against |
1148 * this criterion, a certificate's version must be equal to the criterion's | 1087 * this criterion, a certificate's version must be equal to the criterion's |
1149 * version. If the criterion's version is -1, no version check is done and | 1088 * version. If the criterion's version is -1, no version check is done and |
1150 * all certificates are considered to match this criterion. | 1089 * all certificates are considered to match this criterion. |
1151 * | 1090 * |
1152 * PARAMETERS: | 1091 * PARAMETERS: |
1153 * "params" | 1092 * "params" |
1154 * Address of ComCertSelParams object whose version criterion is to be | 1093 * Address of ComCertSelParams object whose version criterion is to be |
1155 * set. Must be non-NULL. | 1094 * set. Must be non-NULL. |
1156 * "version" | 1095 * "version" |
1157 * Value of PKIX_Int32 used to set the criterion | 1096 * Value of PKIX_Int32 used to set the criterion |
1158 * (or -1 to disable the criterion). | 1097 * (or -1 to disable the criterion). |
1159 * "plContext" | 1098 * "plContext" |
1160 * Platform-specific context pointer. | 1099 * Platform-specific context pointer. |
1161 * THREAD SAFETY: | 1100 * THREAD SAFETY: |
1162 * Not Thread Safe - assumes exclusive access to "params" | 1101 * Not Thread Safe - assumes exclusive access to "params" |
1163 * (see Thread Safety Definitions in Programmer's Guide) | 1102 * (see Thread Safety Definitions in Programmer's Guide) |
1164 * RETURNS: | 1103 * RETURNS: |
1165 * Returns NULL if the function succeeds. | 1104 * Returns NULL if the function succeeds. |
1166 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1105 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1167 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1106 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1168 */ | 1107 */ |
1169 PKIX_Error * | 1108 PKIX_Error *PKIX_ComCertSelParams_SetVersion(PKIX_ComCertSelParams *params, |
1170 PKIX_ComCertSelParams_SetVersion( | 1109 PKIX_Int32 version, |
1171 PKIX_ComCertSelParams *params, | 1110 void *plContext); |
1172 PKIX_Int32 version, | |
1173 void *plContext); | |
1174 | |
1175 | 1111 |
1176 /* | 1112 /* |
1177 * FUNCTION: PKIX_ComCertSelParams_GetKeyUsage | 1113 * FUNCTION: PKIX_ComCertSelParams_GetKeyUsage |
1178 * DESCRIPTION: | 1114 * DESCRIPTION: |
1179 * | 1115 * |
1180 * Retrieves a PKIX_UInt32 (if any) representing the key usage criterion that | 1116 * Retrieves a PKIX_UInt32 (if any) representing the key usage criterion that |
1181 * is set in the ComCertSelParams object pointed to by "params" and stores it | 1117 * is set in the ComCertSelParams object pointed to by "params" and stores it |
1182 * at "pKeyUsage". In order to match against this criterion, a certificate | 1118 * at "pKeyUsage". In order to match against this criterion, a certificate |
1183 * must allow the criterion's key usage values. Note that a certificate that | 1119 * must allow the criterion's key usage values. Note that a certificate that |
1184 * has no KeyUsage extension implicity allows all key usages. Note also that | 1120 * has no KeyUsage extension implicity allows all key usages. Note also that |
(...skipping 12 matching lines...) Expand all Loading... |
1197 * "plContext" | 1133 * "plContext" |
1198 * Platform-specific context pointer. | 1134 * Platform-specific context pointer. |
1199 * THREAD SAFETY: | 1135 * THREAD SAFETY: |
1200 * Conditionally Thread Safe | 1136 * Conditionally Thread Safe |
1201 * (see Thread Safety Definitions in Programmer's Guide) | 1137 * (see Thread Safety Definitions in Programmer's Guide) |
1202 * RETURNS: | 1138 * RETURNS: |
1203 * Returns NULL if the function succeeds. | 1139 * Returns NULL if the function succeeds. |
1204 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1140 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1205 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1141 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1206 */ | 1142 */ |
1207 PKIX_Error * | 1143 PKIX_Error *PKIX_ComCertSelParams_GetKeyUsage(PKIX_ComCertSelParams *params, |
1208 PKIX_ComCertSelParams_GetKeyUsage( | 1144 PKIX_UInt32 *pKeyUsage, |
1209 PKIX_ComCertSelParams *params, | 1145 void *plContext); |
1210 PKIX_UInt32 *pKeyUsage, | |
1211 void *plContext); | |
1212 | 1146 |
1213 /* | 1147 /* |
1214 * FUNCTION: PKIX_ComCertSelParams_SetKeyUsage | 1148 * FUNCTION: PKIX_ComCertSelParams_SetKeyUsage |
1215 * DESCRIPTION: | 1149 * DESCRIPTION: |
1216 * | 1150 * |
1217 * Sets the key usage criterion of the ComCertSelParams object pointed to by | 1151 * Sets the key usage criterion of the ComCertSelParams object pointed to by |
1218 * "params" using the integer value of "keyUsage". In order to match against | 1152 * "params" using the integer value of "keyUsage". In order to match against |
1219 * this criterion, a certificate must allow the criterion's key usage values. | 1153 * this criterion, a certificate must allow the criterion's key usage values. |
1220 * Note that a certificate that has no KeyUsage extension implicity allows | 1154 * Note that a certificate that has no KeyUsage extension implicity allows |
1221 * all key usages. Note also that this functions supports a maximum of 32 key | 1155 * all key usages. Note also that this functions supports a maximum of 32 key |
(...skipping 12 matching lines...) Expand all Loading... |
1234 * "plContext" | 1168 * "plContext" |
1235 * Platform-specific context pointer. | 1169 * Platform-specific context pointer. |
1236 * THREAD SAFETY: | 1170 * THREAD SAFETY: |
1237 * Not Thread Safe - assumes exclusive access to "params" | 1171 * Not Thread Safe - assumes exclusive access to "params" |
1238 * (see Thread Safety Definitions in Programmer's Guide) | 1172 * (see Thread Safety Definitions in Programmer's Guide) |
1239 * RETURNS: | 1173 * RETURNS: |
1240 * Returns NULL if the function succeeds. | 1174 * Returns NULL if the function succeeds. |
1241 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1175 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1242 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1176 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1243 */ | 1177 */ |
1244 PKIX_Error * | 1178 PKIX_Error *PKIX_ComCertSelParams_SetKeyUsage(PKIX_ComCertSelParams *params, |
1245 PKIX_ComCertSelParams_SetKeyUsage( | 1179 PKIX_UInt32 keyUsage, |
1246 PKIX_ComCertSelParams *params, | 1180 void *plContext); |
1247 PKIX_UInt32 keyUsage, | |
1248 void *plContext); | |
1249 | 1181 |
1250 /* | 1182 /* |
1251 * FUNCTION: PKIX_ComCertSelParams_GetExtendedKeyUsage | 1183 * FUNCTION: PKIX_ComCertSelParams_GetExtendedKeyUsage |
1252 * DESCRIPTION: | 1184 * DESCRIPTION: |
1253 * | 1185 * |
1254 * Retrieves a pointer to the List of OIDs (if any) representing the extended | 1186 * Retrieves a pointer to the List of OIDs (if any) representing the extended |
1255 * key usage criterion that is set in the ComCertSelParams object pointed to | 1187 * key usage criterion that is set in the ComCertSelParams object pointed to |
1256 * by "params" and stores it at "pExtKeyUsage". In order to match against this | 1188 * by "params" and stores it at "pExtKeyUsage". In order to match against this |
1257 * criterion, a certificate's ExtendedKeyUsage extension must allow the | 1189 * criterion, a certificate's ExtendedKeyUsage extension must allow the |
1258 * criterion's extended key usages. Note that a certificate that has no | 1190 * criterion's extended key usages. Note that a certificate that has no |
(...skipping 14 matching lines...) Expand all Loading... |
1273 * "plContext" | 1205 * "plContext" |
1274 * Platform-specific context pointer. | 1206 * Platform-specific context pointer. |
1275 * THREAD SAFETY: | 1207 * THREAD SAFETY: |
1276 * Conditionally Thread Safe | 1208 * Conditionally Thread Safe |
1277 * (see Thread Safety Definitions in Programmer's Guide) | 1209 * (see Thread Safety Definitions in Programmer's Guide) |
1278 * RETURNS: | 1210 * RETURNS: |
1279 * Returns NULL if the function succeeds. | 1211 * Returns NULL if the function succeeds. |
1280 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1212 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1281 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1213 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1282 */ | 1214 */ |
1283 PKIX_Error * | 1215 PKIX_Error *PKIX_ComCertSelParams_GetExtendedKeyUsage( |
1284 PKIX_ComCertSelParams_GetExtendedKeyUsage( | 1216 PKIX_ComCertSelParams *params, |
1285 PKIX_ComCertSelParams *params, | 1217 PKIX_List **pExtKeyUsage, /* list of PKIX_PL_OID */ |
1286 PKIX_List **pExtKeyUsage, /* list of PKIX_PL_OID */ | 1218 void *plContext); |
1287 void *plContext); | |
1288 | 1219 |
1289 /* | 1220 /* |
1290 * FUNCTION: PKIX_ComCertSelParams_SetExtendedKeyUsage | 1221 * FUNCTION: PKIX_ComCertSelParams_SetExtendedKeyUsage |
1291 * DESCRIPTION: | 1222 * DESCRIPTION: |
1292 * | 1223 * |
1293 * Sets the extended key usage criterion of the ComCertSelParams object | 1224 * Sets the extended key usage criterion of the ComCertSelParams object |
1294 * pointed to by "params" using a List of OIDs pointed to by "extKeyUsage". | 1225 * pointed to by "params" using a List of OIDs pointed to by "extKeyUsage". |
1295 * In order to match against this criterion, a certificate's ExtendedKeyUsage | 1226 * In order to match against this criterion, a certificate's ExtendedKeyUsage |
1296 * extension must allow the criterion's extended key usages. Note that a | 1227 * extension must allow the criterion's extended key usages. Note that a |
1297 * certificate that has no ExtendedKeyUsage extension implicitly allows all | 1228 * certificate that has no ExtendedKeyUsage extension implicitly allows all |
(...skipping 12 matching lines...) Expand all Loading... |
1310 * "plContext" | 1241 * "plContext" |
1311 * Platform-specific context pointer. | 1242 * Platform-specific context pointer. |
1312 * THREAD SAFETY: | 1243 * THREAD SAFETY: |
1313 * Not Thread Safe - assumes exclusive access to "params" | 1244 * Not Thread Safe - assumes exclusive access to "params" |
1314 * (see Thread Safety Definitions in Programmer's Guide) | 1245 * (see Thread Safety Definitions in Programmer's Guide) |
1315 * RETURNS: | 1246 * RETURNS: |
1316 * Returns NULL if the function succeeds. | 1247 * Returns NULL if the function succeeds. |
1317 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1248 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1318 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1249 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1319 */ | 1250 */ |
1320 PKIX_Error * | 1251 PKIX_Error *PKIX_ComCertSelParams_SetExtendedKeyUsage( |
1321 PKIX_ComCertSelParams_SetExtendedKeyUsage( | 1252 PKIX_ComCertSelParams *params, |
1322 PKIX_ComCertSelParams *params, | 1253 PKIX_List *extKeyUsage, /* list of PKIX_PL_OID */ |
1323 PKIX_List *extKeyUsage, /* list of PKIX_PL_OID */ | 1254 void *plContext); |
1324 void *plContext); | |
1325 | 1255 |
1326 /* | 1256 /* |
1327 * FUNCTION: PKIX_ComCertSelParams_GetPolicy | 1257 * FUNCTION: PKIX_ComCertSelParams_GetPolicy |
1328 * DESCRIPTION: | 1258 * DESCRIPTION: |
1329 * | 1259 * |
1330 * Retrieves a pointer to the List of OIDs (if any) representing the policy | 1260 * Retrieves a pointer to the List of OIDs (if any) representing the policy |
1331 * criterion that is set in the ComCertSelParams object pointed to by | 1261 * criterion that is set in the ComCertSelParams object pointed to by |
1332 * "params" and stores it at "pPolicy". In order to match against this | 1262 * "params" and stores it at "pPolicy". In order to match against this |
1333 * criterion, a certificate's CertificatePolicies extension must include at | 1263 * criterion, a certificate's CertificatePolicies extension must include at |
1334 * least one of the criterion's policies. If "params" has this criterion set, | 1264 * least one of the criterion's policies. If "params" has this criterion set, |
(...skipping 15 matching lines...) Expand all Loading... |
1350 * "plContext" | 1280 * "plContext" |
1351 * Platform-specific context pointer. | 1281 * Platform-specific context pointer. |
1352 * THREAD SAFETY: | 1282 * THREAD SAFETY: |
1353 * Conditionally Thread Safe | 1283 * Conditionally Thread Safe |
1354 * (see Thread Safety Definitions in Programmer's Guide) | 1284 * (see Thread Safety Definitions in Programmer's Guide) |
1355 * RETURNS: | 1285 * RETURNS: |
1356 * Returns NULL if the function succeeds. | 1286 * Returns NULL if the function succeeds. |
1357 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1287 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1358 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1288 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1359 */ | 1289 */ |
1360 PKIX_Error * | 1290 PKIX_Error *PKIX_ComCertSelParams_GetPolicy( |
1361 PKIX_ComCertSelParams_GetPolicy( | 1291 PKIX_ComCertSelParams *params, |
1362 PKIX_ComCertSelParams *params, | 1292 PKIX_List **pPolicy, /* list of PKIX_PL_OID */ |
1363 PKIX_List **pPolicy, /* list of PKIX_PL_OID */ | 1293 void *plContext); |
1364 void *plContext); | |
1365 | 1294 |
1366 /* | 1295 /* |
1367 * FUNCTION: PKIX_ComCertSelParams_SetPolicy | 1296 * FUNCTION: PKIX_ComCertSelParams_SetPolicy |
1368 * DESCRIPTION: | 1297 * DESCRIPTION: |
1369 * | 1298 * |
1370 * Sets the policy criterion of the ComCertSelParams object pointed to by | 1299 * Sets the policy criterion of the ComCertSelParams object pointed to by |
1371 * "params" using a List of OIDs pointed to by "policy". In order to match | 1300 * "params" using a List of OIDs pointed to by "policy". In order to match |
1372 * against this criterion, a certificate's CertificatePolicies extension must | 1301 * against this criterion, a certificate's CertificatePolicies extension must |
1373 * include at least one of the criterion's policies. If "params" has this | 1302 * include at least one of the criterion's policies. If "params" has this |
1374 * criterion set, but the List of OIDs is empty, then a certificate's | 1303 * criterion set, but the List of OIDs is empty, then a certificate's |
(...skipping 12 matching lines...) Expand all Loading... |
1387 * "plContext" | 1316 * "plContext" |
1388 * Platform-specific context pointer. | 1317 * Platform-specific context pointer. |
1389 * THREAD SAFETY: | 1318 * THREAD SAFETY: |
1390 * Not Thread Safe - assumes exclusive access to "params" | 1319 * Not Thread Safe - assumes exclusive access to "params" |
1391 * (see Thread Safety Definitions in Programmer's Guide) | 1320 * (see Thread Safety Definitions in Programmer's Guide) |
1392 * RETURNS: | 1321 * RETURNS: |
1393 * Returns NULL if the function succeeds. | 1322 * Returns NULL if the function succeeds. |
1394 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1323 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1395 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1324 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1396 */ | 1325 */ |
1397 PKIX_Error * | 1326 PKIX_Error *PKIX_ComCertSelParams_SetPolicy(PKIX_ComCertSelParams *params, |
1398 PKIX_ComCertSelParams_SetPolicy( | 1327 PKIX_List *policy, /* list of |
1399 PKIX_ComCertSelParams *params, | 1328 PKIX_PL_OID */ |
1400 PKIX_List *policy, /* list of PKIX_PL_OID */ | 1329 void *plContext); |
1401 void *plContext); | |
1402 | 1330 |
1403 /* | 1331 /* |
1404 * FUNCTION: PKIX_ComCertSelParams_GetIssuer | 1332 * FUNCTION: PKIX_ComCertSelParams_GetIssuer |
1405 * DESCRIPTION: | 1333 * DESCRIPTION: |
1406 * | 1334 * |
1407 * Retrieves a pointer to the X500Name (if any) representing the issuer | 1335 * Retrieves a pointer to the X500Name (if any) representing the issuer |
1408 * criterion that is set in the ComCertSelParams object pointed to by | 1336 * criterion that is set in the ComCertSelParams object pointed to by |
1409 * "params" and stores it at "pIssuer". In order to match against this | 1337 * "params" and stores it at "pIssuer". In order to match against this |
1410 * criterion, a certificate's IssuerName must match the criterion's issuer | 1338 * criterion, a certificate's IssuerName must match the criterion's issuer |
1411 * name. | 1339 * name. |
(...skipping 11 matching lines...) Expand all Loading... |
1423 * "plContext" | 1351 * "plContext" |
1424 * Platform-specific context pointer. | 1352 * Platform-specific context pointer. |
1425 * THREAD SAFETY: | 1353 * THREAD SAFETY: |
1426 * Conditionally Thread Safe | 1354 * Conditionally Thread Safe |
1427 * (see Thread Safety Definitions in Programmer's Guide) | 1355 * (see Thread Safety Definitions in Programmer's Guide) |
1428 * RETURNS: | 1356 * RETURNS: |
1429 * Returns NULL if the function succeeds. | 1357 * Returns NULL if the function succeeds. |
1430 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1358 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1431 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1359 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1432 */ | 1360 */ |
1433 PKIX_Error * | 1361 PKIX_Error *PKIX_ComCertSelParams_GetIssuer(PKIX_ComCertSelParams *params, |
1434 PKIX_ComCertSelParams_GetIssuer( | 1362 PKIX_PL_X500Name **pIssuer, |
1435 PKIX_ComCertSelParams *params, | 1363 void *plContext); |
1436 PKIX_PL_X500Name **pIssuer, | |
1437 void *plContext); | |
1438 | 1364 |
1439 /* | 1365 /* |
1440 * FUNCTION: PKIX_ComCertSelParams_SetIssuer | 1366 * FUNCTION: PKIX_ComCertSelParams_SetIssuer |
1441 * DESCRIPTION: | 1367 * DESCRIPTION: |
1442 * | 1368 * |
1443 * Sets the issuer criterion of the ComCertSelParams object pointed to by | 1369 * Sets the issuer criterion of the ComCertSelParams object pointed to by |
1444 * "params" using an X500Name pointed to by "issuer". In order to match | 1370 * "params" using an X500Name pointed to by "issuer". In order to match |
1445 * against this criterion, a certificate's IssuerName must match the | 1371 * against this criterion, a certificate's IssuerName must match the |
1446 * criterion's issuer name. | 1372 * criterion's issuer name. |
1447 * | 1373 * |
(...skipping 10 matching lines...) Expand all Loading... |
1458 * "plContext" | 1384 * "plContext" |
1459 * Platform-specific context pointer. | 1385 * Platform-specific context pointer. |
1460 * THREAD SAFETY: | 1386 * THREAD SAFETY: |
1461 * Not Thread Safe - assumes exclusive access to "params" | 1387 * Not Thread Safe - assumes exclusive access to "params" |
1462 * (see Thread Safety Definitions in Programmer's Guide) | 1388 * (see Thread Safety Definitions in Programmer's Guide) |
1463 * RETURNS: | 1389 * RETURNS: |
1464 * Returns NULL if the function succeeds. | 1390 * Returns NULL if the function succeeds. |
1465 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1391 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1466 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1392 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1467 */ | 1393 */ |
1468 PKIX_Error * | 1394 PKIX_Error *PKIX_ComCertSelParams_SetIssuer(PKIX_ComCertSelParams *params, |
1469 PKIX_ComCertSelParams_SetIssuer( | 1395 PKIX_PL_X500Name *issuer, |
1470 PKIX_ComCertSelParams *params, | 1396 void *plContext); |
1471 PKIX_PL_X500Name *issuer, | |
1472 void *plContext); | |
1473 | 1397 |
1474 /* | 1398 /* |
1475 * FUNCTION: PKIX_ComCertSelParams_GetSubject | 1399 * FUNCTION: PKIX_ComCertSelParams_GetSubject |
1476 * DESCRIPTION: | 1400 * DESCRIPTION: |
1477 * | 1401 * |
1478 * Retrieves a pointer to the X500Name (if any) representing the subject | 1402 * Retrieves a pointer to the X500Name (if any) representing the subject |
1479 * criterion that is set in the ComCertSelParams object pointed to by | 1403 * criterion that is set in the ComCertSelParams object pointed to by |
1480 * "params" and stores it at "pSubject". In order to match against this | 1404 * "params" and stores it at "pSubject". In order to match against this |
1481 * criterion, a certificate's SubjectName must match the criterion's subject | 1405 * criterion, a certificate's SubjectName must match the criterion's subject |
1482 * name. | 1406 * name. |
(...skipping 11 matching lines...) Expand all Loading... |
1494 * "plContext" | 1418 * "plContext" |
1495 * Platform-specific context pointer. | 1419 * Platform-specific context pointer. |
1496 * THREAD SAFETY: | 1420 * THREAD SAFETY: |
1497 * Conditionally Thread Safe | 1421 * Conditionally Thread Safe |
1498 * (see Thread Safety Definitions in Programmer's Guide) | 1422 * (see Thread Safety Definitions in Programmer's Guide) |
1499 * RETURNS: | 1423 * RETURNS: |
1500 * Returns NULL if the function succeeds. | 1424 * Returns NULL if the function succeeds. |
1501 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1425 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1502 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1426 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1503 */ | 1427 */ |
1504 PKIX_Error * | 1428 PKIX_Error *PKIX_ComCertSelParams_GetSubject(PKIX_ComCertSelParams *params, |
1505 PKIX_ComCertSelParams_GetSubject( | 1429 PKIX_PL_X500Name **pSubject, |
1506 PKIX_ComCertSelParams *params, | 1430 void *plContext); |
1507 PKIX_PL_X500Name **pSubject, | |
1508 void *plContext); | |
1509 | 1431 |
1510 /* | 1432 /* |
1511 * FUNCTION: PKIX_ComCertSelParams_SetSubject | 1433 * FUNCTION: PKIX_ComCertSelParams_SetSubject |
1512 * DESCRIPTION: | 1434 * DESCRIPTION: |
1513 * | 1435 * |
1514 * Sets the subject criterion of the ComCertSelParams object pointed to by | 1436 * Sets the subject criterion of the ComCertSelParams object pointed to by |
1515 * "params" using an X500Name pointed to by "subject". In order to match | 1437 * "params" using an X500Name pointed to by "subject". In order to match |
1516 * against this criterion, a certificate's SubjectName must match the | 1438 * against this criterion, a certificate's SubjectName must match the |
1517 * criterion's subject name. | 1439 * criterion's subject name. |
1518 * | 1440 * |
(...skipping 10 matching lines...) Expand all Loading... |
1529 * "plContext" | 1451 * "plContext" |
1530 * Platform-specific context pointer. | 1452 * Platform-specific context pointer. |
1531 * THREAD SAFETY: | 1453 * THREAD SAFETY: |
1532 * Not Thread Safe - assumes exclusive access to "params" | 1454 * Not Thread Safe - assumes exclusive access to "params" |
1533 * (see Thread Safety Definitions in Programmer's Guide) | 1455 * (see Thread Safety Definitions in Programmer's Guide) |
1534 * RETURNS: | 1456 * RETURNS: |
1535 * Returns NULL if the function succeeds. | 1457 * Returns NULL if the function succeeds. |
1536 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1458 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1537 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1459 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1538 */ | 1460 */ |
1539 PKIX_Error * | 1461 PKIX_Error *PKIX_ComCertSelParams_SetSubject(PKIX_ComCertSelParams *params, |
1540 PKIX_ComCertSelParams_SetSubject( | 1462 PKIX_PL_X500Name *subject, |
1541 PKIX_ComCertSelParams *params, | 1463 void *plContext); |
1542 PKIX_PL_X500Name *subject, | |
1543 void *plContext); | |
1544 | 1464 |
1545 /* | 1465 /* |
1546 * FUNCTION: PKIX_ComCertSelParams_GetSubjectAsByteArray | 1466 * FUNCTION: PKIX_ComCertSelParams_GetSubjectAsByteArray |
1547 * DESCRIPTION: | 1467 * DESCRIPTION: |
1548 * | 1468 * |
1549 * Retrieves a pointer to the ByteArray (if any) representing the subject | 1469 * Retrieves a pointer to the ByteArray (if any) representing the subject |
1550 * criterion that is set in the ComCertSelParams object pointed to by | 1470 * criterion that is set in the ComCertSelParams object pointed to by |
1551 * "params" and stores it at "pSubject". In order to match against this | 1471 * "params" and stores it at "pSubject". In order to match against this |
1552 * criterion, a certificate's SubjectName must match the criterion's subject | 1472 * criterion, a certificate's SubjectName must match the criterion's subject |
1553 * name. | 1473 * name. |
(...skipping 11 matching lines...) Expand all Loading... |
1565 * "plContext" | 1485 * "plContext" |
1566 * Platform-specific context pointer. | 1486 * Platform-specific context pointer. |
1567 * THREAD SAFETY: | 1487 * THREAD SAFETY: |
1568 * Conditionally Thread Safe | 1488 * Conditionally Thread Safe |
1569 * (see Thread Safety Definitions in Programmer's Guide) | 1489 * (see Thread Safety Definitions in Programmer's Guide) |
1570 * RETURNS: | 1490 * RETURNS: |
1571 * Returns NULL if the function succeeds. | 1491 * Returns NULL if the function succeeds. |
1572 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1492 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1573 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1493 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1574 */ | 1494 */ |
1575 PKIX_Error * | 1495 PKIX_Error *PKIX_ComCertSelParams_GetSubjectAsByteArray( |
1576 PKIX_ComCertSelParams_GetSubjectAsByteArray( | 1496 PKIX_ComCertSelParams *params, PKIX_PL_ByteArray **pSubject, |
1577 PKIX_ComCertSelParams *params, | 1497 void *plContext); |
1578 PKIX_PL_ByteArray **pSubject, | |
1579 void *plContext); | |
1580 | 1498 |
1581 /* | 1499 /* |
1582 * FUNCTION: PKIX_ComCertSelParams_SetSubjectAsByteArray | 1500 * FUNCTION: PKIX_ComCertSelParams_SetSubjectAsByteArray |
1583 * DESCRIPTION: | 1501 * DESCRIPTION: |
1584 * | 1502 * |
1585 * Sets the subject criterion of the ComCertSelParams object pointed to by | 1503 * Sets the subject criterion of the ComCertSelParams object pointed to by |
1586 * "params" using a ByteArray pointed to by "subject". In order to match | 1504 * "params" using a ByteArray pointed to by "subject". In order to match |
1587 * against this criterion, a certificate's SubjectName must match the | 1505 * against this criterion, a certificate's SubjectName must match the |
1588 * criterion's subject name. | 1506 * criterion's subject name. |
1589 * | 1507 * |
(...skipping 10 matching lines...) Expand all Loading... |
1600 * "plContext" | 1518 * "plContext" |
1601 * Platform-specific context pointer. | 1519 * Platform-specific context pointer. |
1602 * THREAD SAFETY: | 1520 * THREAD SAFETY: |
1603 * Not Thread Safe - assumes exclusive access to "params" | 1521 * Not Thread Safe - assumes exclusive access to "params" |
1604 * (see Thread Safety Definitions in Programmer's Guide) | 1522 * (see Thread Safety Definitions in Programmer's Guide) |
1605 * RETURNS: | 1523 * RETURNS: |
1606 * Returns NULL if the function succeeds. | 1524 * Returns NULL if the function succeeds. |
1607 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1525 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1608 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1526 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1609 */ | 1527 */ |
1610 PKIX_Error * | 1528 PKIX_Error *PKIX_ComCertSelParams_SetSubjectAsByteArray( |
1611 PKIX_ComCertSelParams_SetSubjectAsByteArray( | 1529 PKIX_ComCertSelParams *params, PKIX_PL_ByteArray *subject, void *plContext); |
1612 PKIX_ComCertSelParams *params, | |
1613 PKIX_PL_ByteArray *subject, | |
1614 void *plContext); | |
1615 | 1530 |
1616 /* | 1531 /* |
1617 * FUNCTION: PKIX_ComCertSelParams_GetNameConstraints | 1532 * FUNCTION: PKIX_ComCertSelParams_GetNameConstraints |
1618 * DESCRIPTION: | 1533 * DESCRIPTION: |
1619 * | 1534 * |
1620 * Retrieves a pointer to the X500Name (if any) representing the name | 1535 * Retrieves a pointer to the X500Name (if any) representing the name |
1621 * constraints criterion that is set in the ComCertSelParams object pointed | 1536 * constraints criterion that is set in the ComCertSelParams object pointed |
1622 * to by "params" and stores it at "pConstraints". In order to match against | 1537 * to by "params" and stores it at "pConstraints". In order to match against |
1623 * this criterion, a certificate's subject and subject alternative names must | 1538 * this criterion, a certificate's subject and subject alternative names must |
1624 * be allowed by the criterion's name constraints. | 1539 * be allowed by the criterion's name constraints. |
(...skipping 11 matching lines...) Expand all Loading... |
1636 * "plContext" | 1551 * "plContext" |
1637 * Platform-specific context pointer. | 1552 * Platform-specific context pointer. |
1638 * THREAD SAFETY: | 1553 * THREAD SAFETY: |
1639 * Conditionally Thread Safe | 1554 * Conditionally Thread Safe |
1640 * (see Thread Safety Definitions in Programmer's Guide) | 1555 * (see Thread Safety Definitions in Programmer's Guide) |
1641 * RETURNS: | 1556 * RETURNS: |
1642 * Returns NULL if the function succeeds. | 1557 * Returns NULL if the function succeeds. |
1643 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1558 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1644 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1559 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1645 */ | 1560 */ |
1646 PKIX_Error * | 1561 PKIX_Error *PKIX_ComCertSelParams_GetNameConstraints( |
1647 PKIX_ComCertSelParams_GetNameConstraints( | 1562 PKIX_ComCertSelParams *params, PKIX_PL_CertNameConstraints **pConstraints, |
1648 PKIX_ComCertSelParams *params, | 1563 void *plContext); |
1649 PKIX_PL_CertNameConstraints **pConstraints, | |
1650 void *plContext); | |
1651 | 1564 |
1652 /* | 1565 /* |
1653 * FUNCTION: PKIX_ComCertSelParams_SetNameConstraints | 1566 * FUNCTION: PKIX_ComCertSelParams_SetNameConstraints |
1654 * DESCRIPTION: | 1567 * DESCRIPTION: |
1655 * | 1568 * |
1656 * Sets the name constraints criterion of the ComCertSelParams object pointed | 1569 * Sets the name constraints criterion of the ComCertSelParams object pointed |
1657 * to by "params" using the CertNameConstraints pointed to by "constraints". | 1570 * to by "params" using the CertNameConstraints pointed to by "constraints". |
1658 * In order to match against this criterion, a certificate's subject and | 1571 * In order to match against this criterion, a certificate's subject and |
1659 * subject alternative names must be allowed by the criterion's name | 1572 * subject alternative names must be allowed by the criterion's name |
1660 * constraints. | 1573 * constraints. |
(...skipping 11 matching lines...) Expand all Loading... |
1672 * "plContext" | 1585 * "plContext" |
1673 * Platform-specific context pointer. | 1586 * Platform-specific context pointer. |
1674 * THREAD SAFETY: | 1587 * THREAD SAFETY: |
1675 * Not Thread Safe - assumes exclusive access to "params" | 1588 * Not Thread Safe - assumes exclusive access to "params" |
1676 * (see Thread Safety Definitions in Programmer's Guide) | 1589 * (see Thread Safety Definitions in Programmer's Guide) |
1677 * RETURNS: | 1590 * RETURNS: |
1678 * Returns NULL if the function succeeds. | 1591 * Returns NULL if the function succeeds. |
1679 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1592 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1680 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1593 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1681 */ | 1594 */ |
1682 PKIX_Error * | 1595 PKIX_Error *PKIX_ComCertSelParams_SetNameConstraints( |
1683 PKIX_ComCertSelParams_SetNameConstraints( | 1596 PKIX_ComCertSelParams *params, PKIX_PL_CertNameConstraints *constraints, |
1684 PKIX_ComCertSelParams *params, | 1597 void *plContext); |
1685 PKIX_PL_CertNameConstraints *constraints, | |
1686 void *plContext); | |
1687 | 1598 |
1688 /* | 1599 /* |
1689 * FUNCTION: PKIX_ComCertSelParams_GetMatchAllSubjAltNames | 1600 * FUNCTION: PKIX_ComCertSelParams_GetMatchAllSubjAltNames |
1690 * DESCRIPTION: | 1601 * DESCRIPTION: |
1691 * | 1602 * |
1692 * Checks whether the ComCertSelParams object pointed to by "params" indicate | 1603 * Checks whether the ComCertSelParams object pointed to by "params" indicate |
1693 * that all subject alternative names are to be matched and stores the Boolean | 1604 * that all subject alternative names are to be matched and stores the Boolean |
1694 * result at "pMatch". This Boolean value determines the behavior of the | 1605 * result at "pMatch". This Boolean value determines the behavior of the |
1695 * subject alternative names criterion. | 1606 * subject alternative names criterion. |
1696 * | 1607 * |
(...skipping 13 matching lines...) Expand all Loading... |
1710 * "plContext" | 1621 * "plContext" |
1711 * Platform-specific context pointer. | 1622 * Platform-specific context pointer. |
1712 * THREAD SAFETY: | 1623 * THREAD SAFETY: |
1713 * Conditionally Thread Safe | 1624 * Conditionally Thread Safe |
1714 * (see Thread Safety Definitions in Programmer's Guide) | 1625 * (see Thread Safety Definitions in Programmer's Guide) |
1715 * RETURNS: | 1626 * RETURNS: |
1716 * Returns NULL if the function succeeds. | 1627 * Returns NULL if the function succeeds. |
1717 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1628 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1718 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1629 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1719 */ | 1630 */ |
1720 PKIX_Error * | 1631 PKIX_Error *PKIX_ComCertSelParams_GetMatchAllSubjAltNames( |
1721 PKIX_ComCertSelParams_GetMatchAllSubjAltNames( | 1632 PKIX_ComCertSelParams *params, PKIX_Boolean *pMatch, void *plContext); |
1722 PKIX_ComCertSelParams *params, | |
1723 PKIX_Boolean *pMatch, | |
1724 void *plContext); | |
1725 | 1633 |
1726 /* | 1634 /* |
1727 * FUNCTION: PKIX_ComCertSelParams_SetMatchAllSubjAltNames | 1635 * FUNCTION: PKIX_ComCertSelParams_SetMatchAllSubjAltNames |
1728 * DESCRIPTION: | 1636 * DESCRIPTION: |
1729 * | 1637 * |
1730 * Sets the match flag of the ComCertSelParams object pointed to by "params" | 1638 * Sets the match flag of the ComCertSelParams object pointed to by "params" |
1731 * using the Boolean value of "match". This Boolean value determines the | 1639 * using the Boolean value of "match". This Boolean value determines the |
1732 * behavior of the subject alternative names criterion. | 1640 * behavior of the subject alternative names criterion. |
1733 * | 1641 * |
1734 * In order to match against the subject alternative names criterion, if the | 1642 * In order to match against the subject alternative names criterion, if the |
(...skipping 11 matching lines...) Expand all Loading... |
1746 * "plContext" | 1654 * "plContext" |
1747 * Platform-specific context pointer. | 1655 * Platform-specific context pointer. |
1748 * THREAD SAFETY: | 1656 * THREAD SAFETY: |
1749 * Not Thread Safe - assumes exclusive access to "params" | 1657 * Not Thread Safe - assumes exclusive access to "params" |
1750 * (see Thread Safety Definitions in Programmer's Guide) | 1658 * (see Thread Safety Definitions in Programmer's Guide) |
1751 * RETURNS: | 1659 * RETURNS: |
1752 * Returns NULL if the function succeeds. | 1660 * Returns NULL if the function succeeds. |
1753 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1661 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1754 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1662 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1755 */ | 1663 */ |
1756 PKIX_Error * | 1664 PKIX_Error *PKIX_ComCertSelParams_SetMatchAllSubjAltNames( |
1757 PKIX_ComCertSelParams_SetMatchAllSubjAltNames( | 1665 PKIX_ComCertSelParams *params, PKIX_Boolean match, void *plContext); |
1758 PKIX_ComCertSelParams *params, | |
1759 PKIX_Boolean match, | |
1760 void *plContext); | |
1761 | 1666 |
1762 /* | 1667 /* |
1763 * FUNCTION: PKIX_ComCertSelParams_GetLeafCertFlag | 1668 * FUNCTION: PKIX_ComCertSelParams_GetLeafCertFlag |
1764 * DESCRIPTION: | 1669 * DESCRIPTION: |
1765 * | 1670 * |
1766 * Return "leafCert" flag of the ComCertSelParams structure. If set to true, | 1671 * Return "leafCert" flag of the ComCertSelParams structure. If set to true, |
1767 * the flag indicates that a selector should filter out all cert that are not | 1672 * the flag indicates that a selector should filter out all cert that are not |
1768 * qualified to be a leaf cert according to the specified key/ekey usages. | 1673 * qualified to be a leaf cert according to the specified key/ekey usages. |
1769 * | 1674 * |
1770 * PARAMETERS: | 1675 * PARAMETERS: |
1771 * "params" | 1676 * "params" |
1772 * Address of ComCertSelParams object used to determine whether all | 1677 * Address of ComCertSelParams object used to determine whether all |
1773 * subject alternative names must be matched. Must be non-NULL. | 1678 * subject alternative names must be matched. Must be non-NULL. |
1774 * "pLeafFlag" | 1679 * "pLeafFlag" |
1775 * Address of returned value. | 1680 * Address of returned value. |
1776 * "plContext" | 1681 * "plContext" |
1777 * Platform-specific context pointer. | 1682 * Platform-specific context pointer. |
1778 * THREAD SAFETY: | 1683 * THREAD SAFETY: |
1779 * Conditionally Thread Safe | 1684 * Conditionally Thread Safe |
1780 * (see Thread Safety Definitions in Programmer's Guide) | 1685 * (see Thread Safety Definitions in Programmer's Guide) |
1781 * RETURNS: | 1686 * RETURNS: |
1782 * Returns NULL if the function succeeds. | 1687 * Returns NULL if the function succeeds. |
1783 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1688 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1784 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1689 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1785 */ | 1690 */ |
1786 PKIX_Error* | 1691 PKIX_Error *PKIX_ComCertSelParams_GetLeafCertFlag(PKIX_ComCertSelParams *params, |
1787 PKIX_ComCertSelParams_GetLeafCertFlag( | 1692 PKIX_Boolean *pLeafFlag, |
1788 PKIX_ComCertSelParams *params, | 1693 void *plContext); |
1789 PKIX_Boolean *pLeafFlag, | |
1790 void *plContext); | |
1791 | 1694 |
1792 /* | 1695 /* |
1793 * FUNCTION: PKIX_ComCertSelParams_SetLeafCertFlag | 1696 * FUNCTION: PKIX_ComCertSelParams_SetLeafCertFlag |
1794 * DESCRIPTION: | 1697 * DESCRIPTION: |
1795 * | 1698 * |
1796 * Sets a flag that if its value is true, indicates that the selector | 1699 * Sets a flag that if its value is true, indicates that the selector |
1797 * should only pick certs that qualifies to be leaf for this cert path | 1700 * should only pick certs that qualifies to be leaf for this cert path |
1798 * validation. | 1701 * validation. |
1799 * | 1702 * |
1800 * PARAMETERS: | 1703 * PARAMETERS: |
1801 * "params" | 1704 * "params" |
1802 * Address of ComCertSelParams object whose match flag is to be set. | 1705 * Address of ComCertSelParams object whose match flag is to be set. |
1803 * Must be non-NULL. | 1706 * Must be non-NULL. |
1804 * "leafFlag" | 1707 * "leafFlag" |
1805 * Boolean value used to set the leaf flag. | 1708 * Boolean value used to set the leaf flag. |
1806 * "plContext" | 1709 * "plContext" |
1807 * Platform-specific context pointer. | 1710 * Platform-specific context pointer. |
1808 * THREAD SAFETY: | 1711 * THREAD SAFETY: |
1809 * Not Thread Safe - assumes exclusive access to "params" | 1712 * Not Thread Safe - assumes exclusive access to "params" |
1810 * (see Thread Safety Definitions in Programmer's Guide) | 1713 * (see Thread Safety Definitions in Programmer's Guide) |
1811 * RETURNS: | 1714 * RETURNS: |
1812 * Returns NULL if the function succeeds. | 1715 * Returns NULL if the function succeeds. |
1813 * Returns a CertSelector Error if the function fails in a non-fatal way. | 1716 * Returns a CertSelector Error if the function fails in a non-fatal way. |
1814 * Returns a Fatal Error if the function fails in an unrecoverable way. | 1717 * Returns a Fatal Error if the function fails in an unrecoverable way. |
1815 */ | 1718 */ |
1816 PKIX_Error * | 1719 PKIX_Error *PKIX_ComCertSelParams_SetLeafCertFlag(PKIX_ComCertSelParams *params, |
1817 PKIX_ComCertSelParams_SetLeafCertFlag( | 1720 PKIX_Boolean leafFlag, |
1818 PKIX_ComCertSelParams *params, | 1721 void *plContext); |
1819 PKIX_Boolean leafFlag, | |
1820 void *plContext); | |
1821 | 1722 |
1822 #ifdef __cplusplus | 1723 #ifdef __cplusplus |
1823 } | 1724 } |
1824 #endif | 1725 #endif |
1825 | 1726 |
1826 #endif /* _PKIX_CERTSEL_H */ | 1727 #endif /* _PKIX_CERTSEL_H */ |
OLD | NEW |