| Top |  |  |  |  | 
| EPhotoCache * | e_photo_cache_new () | 
| EClientCache * | e_photo_cache_ref_client_cache () | 
|  | e_photo_cache_add_photo_source () | 
|  | e_photo_cache_list_photo_sources () | 
|  | e_photo_cache_remove_photo_source () | 
|  | e_photo_cache_add_photo () | 
|  | e_photo_cache_remove_photo () | 
|  | e_photo_cache_get_photo_sync () | 
|  | e_photo_cache_get_photo () | 
|  | e_photo_cache_get_photo_finish () | 
EPhotoCache finds photos associated with an email address.
A limited internal cache is employed to speed up frequently searched email addresses. The exact caching semantics are private and subject to change.
EPhotoCache *
e_photo_cache_new (EClientCache *client_cache);
Creates a new EPhotoCache instance.
EClientCache *
e_photo_cache_ref_client_cache (EPhotoCache *photo_cache);
Returns the EClientCache passed to e_photo_cache_new().
The returned EClientCache is referenced for thread-safety and must be
unreferenced with g_object_unref()
void e_photo_cache_add_photo_source (EPhotoCache *photo_cache,);EPhotoSource *photo_source
Adds photo_source
 as a potential source of photos.
GList * e_photo_cache_list_photo_sources (EPhotoCache *photo_cache);
Returns a list of photo sources for photo_cache
.
The sources returned in the list are referenced for thread-safety.
They must each be unreferenced with g_object_unref()g_list_free()
An easy way to free the list property in one step is as follows:
g_list_free_full (list, g_object_unref);
gboolean e_photo_cache_remove_photo_source (EPhotoCache *photo_cache,);EPhotoSource *photo_source
Removes photo_source
 as a potential source of photos.
void e_photo_cache_add_photo (EPhotoCache *photo_cache,const,gchar *email_address);GBytes *bytes
Adds a cache entry for email_address
, such that subsequent photo requests
for email_address
 will yield a bytes
without consulting available photo sources.
The bytes
 argument can also be NULLemail_address
.  Subsequent photo requests for email_address
 will yield no
input stream.
The entry may be removed without notice however, subject to photo_cache
's
internal caching policy.
| photo_cache | an EPhotoCache | |
| email_address | an email address | |
| bytes | a  | 
gboolean e_photo_cache_remove_photo (EPhotoCache *photo_cache,const);gchar *email_address
Removes the cache entry for email_address
, if such an entry exists.
gboolean e_photo_cache_get_photo_sync (EPhotoCache *photo_cache,const,gchar *email_address,GCancellable *cancellable,GInputStream **out_stream);GError **error
Searches available photo sources for a photo associated with
email_address
.
If a match is found, a out_stream
 return location.  If no match is found,
the out_stream
 return location is set to NULL
The return value indicates whether the search completed successfully,
not whether a match was found.  If an error occurs, the function will
set error
 and return FALSE
| photo_cache | an EPhotoCache | |
| email_address | an email address | |
| cancellable | optional  | |
| out_stream | return location for a  | |
| error | return location for a  | 
void e_photo_cache_get_photo (EPhotoCache *photo_cache,const,gchar *email_address,GCancellable *cancellable,GAsyncReadyCallback callback);gpointer user_data
Asynchronously searches available photo sources for a photo associated
with email_address
.
When the operation is finished, callback
 will be called.  You can then
call e_photo_cache_get_photo_finish() to get the result of the operation.
| photo_cache | an EPhotoCache | |
| email_address | an email address | |
| cancellable | optional  | |
| callback | a  | |
| user_data | data to pass to the callback function | 
gboolean e_photo_cache_get_photo_finish (EPhotoCache *photo_cache,,GAsyncResult *result,GInputStream **out_stream);GError **error
Finishes the operation started with e_photo_cache_get_photo().
If a match was found, a out_stream
 return location.  If no match was found,
the out_stream
 return location is set to NULL
The return value indicates whether the search completed successfully,
not whether a match was found.  If an error occurred, the function will
set error
 and return FALSE
| photo_cache | an EPhotoCache | |
| result | a  | |
| out_stream | return location for a  | |
| error | return location for a  |