WebKit2.FaviconDatabase.get_favicon

### Method

# WebKit2 FaviconDatabaseget_favicon

#### Declaration [src]

    void
    webkit_favicon_database_get_favicon (
      WebKitFaviconDatabase* database,
      const gchar* page_uri,
      GCancellable* cancellable,
      GAsyncReadyCallback callback,
      gpointer user_data
    )

#### Description [src]

Asynchronously obtains a #cairo_surface_t of the favicon.

Asynchronously obtains a #cairo_surface_t of the favicon for the given page URI. It returns the cached icon if it’s in the database asynchronously waiting for the icon to be read from the database.

This is an asynchronous method. When the operation is finished, callback will be invoked. You can then call `webkit_favicon_database_get_favicon_finish()` to get the result of the operation.

You must call `webkit_web_context_set_favicon_database_directory()` for the `WebKitWebContext` associated with this `WebKitFaviconDatabase` before attempting to use this function; otherwise, `webkit_favicon_database_get_favicon_finish()` will return `WEBKIT_FAVICON_DATABASE_ERROR_NOT_INITIALIZED`.

#### Parameters

`page_uri` | `const gchar*`
| URI of the page for which we want to retrieve the favicon.
| The data is owned by the caller of the function.
| The value is a NUL terminated UTF-8 string.
`cancellable` | `GCancellable`
| A `GCancellable` or `NULL`.
| The argument can be `NULL`.
| The data is owned by the caller of the function.
`callback` | `GAsyncReadyCallback`
| A `GAsyncReadyCallback` to call when the request is satisfied or `NULL` if you don’t care about the result.
| The argument can be `NULL`.
`user_data` | `gpointer`
| The data to pass to `callback`.
| The argument can be `NULL`.
| The data is owned by the caller of the function.