get_autocrypt_gossip_headers_from_inner_part
Description:
Creates a new AutocryptHeaderList of relevant headers of the given type based on the recipient(s) of an e-mail message.
You must pass the decrypted inner part of the message to this function, since Autocrypt-Gossip headers are only stored within the encrypted layer.
If you don't already have the decrypted inner part available to you, you probably want to use get_autocrypt_gossip_headers instead.
Each header in the returned list will:
- have a valid address
- be of the type requested
- be complete
If no Autocrypt header is found for a recipient, no AutocryptHeader will be in the list associated with that e-mail address.
Note that the following types of Autocrypt headers will not be returned by this function:
- headers of an unrequested type
- headers that do not match an address in "From:"
- unparseable headers
- headers with unknown critical attributes
- duplicate valid headers for a given address
On error (e.g. if this version of GMime cannot handle the requested Autocrypt type, or if a parameter is missing or malformed), returns null
The returned Autocrypt headers will have their effective_date set to the earliest of either:
- the Date: header of the message or
now
(or the current time, ifnow
is null)
Parameters:
this |
a Message object. |
now |
a DateTime object, or null |
inner_part |
a Object which is the cleartext part of the inner message |
Returns:
a new AutocryptHeaderList object, or null on error. |