1/*
2 *  Copyright (c) 2004,2011,2014 Apple Inc. All Rights Reserved.
3 *
4 *  @APPLE_LICENSE_HEADER_START@
5 *
6 *  This file contains Original Code and/or Modifications of Original Code
7 *  as defined in and that are subject to the Apple Public Source License
8 *  Version 2.0 (the 'License'). You may not use this file except in
9 *  compliance with the License. Please obtain a copy of the License at
10 *  http://www.opensource.apple.com/apsl/ and read it before using this
11 *  file.
12 *
13 *  The Original Code and all software distributed under the License are
14 *  distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
15 *  EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16 *  INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
17 *  FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18 *  Please see the License for the specific language governing rights and
19 *  limitations under the License.
20 *
21 *  @APPLE_LICENSE_HEADER_END@
22 */
23
24/*!
25    @header SecCmsRecipientInfo.h
26    @Copyright (c) 2004,2011,2014 Apple Inc. All Rights Reserved.
27
28    @availability 10.4 and later
29    @abstract Interfaces of the CMS implementation.
30    @discussion The functions here implement functions for encoding
31                and decoding Cryptographic Message Syntax (CMS) objects
32                as described in rfc3369.
33 */
34
35#ifndef _SECURITY_SECCMSRECIPIENTINFO_H_
36#define _SECURITY_SECCMSRECIPIENTINFO_H_  1
37
38#include <Security/SecCmsBase.h>
39
40
41#if defined(__cplusplus)
42extern "C" {
43#endif
44
45
46/*!
47    @function
48    @abstract Create a recipientinfo
49    @discussion We currently do not create KeyAgreement recipientinfos with multiple recipientEncryptedKeys
50                the certificate is supposed to have been verified by the caller
51 */
52extern SecCmsRecipientInfoRef
53SecCmsRecipientInfoCreate(SecCmsMessageRef cmsg, SecCertificateRef cert);
54
55/*!
56    @function
57 */
58extern SecCmsRecipientInfoRef
59SecCmsRecipientInfoCreateWithSubjKeyID(SecCmsMessageRef cmsg,
60                                         CSSM_DATA_PTR subjKeyID,
61                                         SecPublicKeyRef pubKey);
62
63/*!
64    @function
65 */
66extern SecCmsRecipientInfoRef
67SecCmsRecipientInfoCreateWithSubjKeyIDFromCert(SecCmsMessageRef cmsg,
68                                                 SecCertificateRef cert);
69
70/*!
71    @function
72 */
73extern void
74SecCmsRecipientInfoDestroy(SecCmsRecipientInfoRef ri);
75
76
77#if defined(__cplusplus)
78}
79#endif
80
81#endif /* _SECURITY_SECCMSRECIPIENTINFO_H_ */
82