Message.getAutocryptGossipHeadersFromInnerPart

Creates a new #GMimeAutocryptHeaderList 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 #g_mime_message_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 #GMimeAutocryptHeader 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, if now is null)

Parameters

now glib.date_time.DateTime

a #GDateTime object, or null

innerPart gmime.object.ObjectWrap

a #GMimeObject which is the cleartext part of the inner message

Return Value

Type: gmime.autocrypt_header_list.AutocryptHeaderList

a new #GMimeAutocryptHeaderList object, or null on error.