5 CMS_get0_type, CMS_set1_eContentType, CMS_get0_eContentType, CMS_get0_content - get and set CMS content types and content
9 #include <openssl/cms.h>
11 const ASN1_OBJECT *CMS_get0_type(const CMS_ContentInfo *cms);
12 int CMS_set1_eContentType(CMS_ContentInfo *cms, const ASN1_OBJECT *oid);
13 const ASN1_OBJECT *CMS_get0_eContentType(CMS_ContentInfo *cms);
14 ASN1_OCTET_STRING **CMS_get0_content(CMS_ContentInfo *cms);
18 CMS_get0_type() returns the content type of a CMS_ContentInfo structure as
19 an ASN1_OBJECT pointer. An application can then decide how to process the
20 CMS_ContentInfo structure based on this value.
22 CMS_set1_eContentType() sets the embedded content type of a CMS_ContentInfo
23 structure. It should be called with CMS functions (such as L<CMS_sign>, L<CMS_encrypt>)
24 with the B<CMS_PARTIAL>
25 flag and B<before> the structure is finalised, otherwise the results are
28 ASN1_OBJECT *CMS_get0_eContentType() returns a pointer to the embedded
31 CMS_get0_content() returns a pointer to the B<ASN1_OCTET_STRING> pointer
32 containing the embedded content.
36 As the B<0> implies CMS_get0_type(), CMS_get0_eContentType() and
37 CMS_get0_content() return internal pointers which should B<not> be freed up.
38 CMS_set1_eContentType() copies the supplied OID and it B<should> be freed up
41 The B<ASN1_OBJECT> values returned can be converted to an integer B<NID> value
42 using OBJ_obj2nid(). For the currently supported content types the following
48 NID_id_smime_ct_compressedData:
52 The return value of CMS_get0_content() is a pointer to the B<ASN1_OCTET_STRING>
53 content pointer. That means that for example:
55 ASN1_OCTET_STRING **pconf = CMS_get0_content(cms);
57 B<*pconf> could be NULL if there is no embedded content. Applications can
58 access, modify or create the embedded content in a B<CMS_ContentInfo> structure
59 using this function. Applications usually will not need to modify the
60 embedded content as it is normally set by higher level functions.
64 CMS_get0_type() and CMS_get0_eContentType() return an ASN1_OBJECT structure.
66 CMS_set1_eContentType() returns 1 for success or 0 if an error occurred. The
67 error can be obtained from ERR_get_error(3).
75 Copyright 2008-2019 The OpenSSL Project Authors. All Rights Reserved.
77 Licensed under the OpenSSL license (the "License"). You may not use
78 this file except in compliance with the License. You can obtain a copy
79 in the file LICENSE in the source distribution or at
80 L<https://www.openssl.org/source/license.html>.