1/*
2 *  Copyright (c) 2004,2008,2010 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 SecCmsEnvelopedData.h
26    @Copyright (c) 2004,2008,2010 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_SECCMSENCRYPTEDDATA_H_
36#define _SECURITY_SECCMSENCRYPTEDDATA_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 an empty EncryptedData object.
49    @param algorithm Specifies the bulk encryption algorithm to use.
50    @param keysize is the key size.
51    @discussion An error results in a return value of NULL and an error set.
52                (Retrieve specific errors via PORT_GetError()/XP_GetError().)
53 */
54extern SecCmsEncryptedDataRef
55SecCmsEncryptedDataCreate(SecCmsMessageRef cmsg, SECOidTag algorithm, int keysize);
56
57/*!
58    @function
59    @abstract Destroy an encryptedData object.
60 */
61extern void
62SecCmsEncryptedDataDestroy(SecCmsEncryptedDataRef encd);
63
64/*!
65    @function
66    @abstract Return pointer to an EncryptedData object's contentInfo.
67 */
68extern SecCmsContentInfoRef
69SecCmsEncryptedDataGetContentInfo(SecCmsEncryptedDataRef encd);
70
71
72#if defined(__cplusplus)
73}
74#endif
75
76#endif /* _SECURITY_SECCMSENCRYPTEDDATA_H_ */
77