/* GIO - GLib Input, Output and Streaming Library

 *

 * Copyright (C) 2006-2007 Red Hat, Inc.

 *

 * This library is free software; you can redistribute it and/or

 * modify it under the terms of the GNU Lesser General Public

 * License as published by the Free Software Foundation; either

 * version 2.1 of the License, or (at your option) any later version.

 *

 * This library is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

 * Lesser General Public License for more details.

 *

 * You should have received a copy of the GNU Lesser General

 * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.

 *

 * Author: Alexander Larsson <alexl@redhat.com>

 */

#include "config.h"

#include "gappinfo.h"

#include "gappinfoprivate.h"

#include "gcontextspecificgroup.h"

#include "gtask.h"

#include "glibintl.h"

#include <gioerror.h>

#include <gfile.h>

#ifdef G_OS_UNIX

#include "gdbusconnection.h"

#include "gdbusmessage.h"

#include "gportalsupport.h"

#include "gunixfdlist.h"

#include "gopenuriportal.h"

#include <sys/types.h>

#include <sys/stat.h>

#include <fcntl.h>

#endif

/**

 * SECTION:gappinfo

 * @short_description: Application information and launch contexts

 * @include: gio/gio.h

 * @see_also: #GAppInfoMonitor

 * 

 * #GAppInfo and #GAppLaunchContext are used for describing and launching

 * applications installed on the system.

 *

 * As of GLib 2.20, URIs will always be converted to POSIX paths

 * (using g_file_get_path()) when using g_app_info_launch() even if

 * the application requested an URI and not a POSIX path. For example

 * for an desktop-file based application with Exec key `totem

 * %U` and a single URI, `sftp://foo/file.avi`, then

 * `/home/user/.gvfs/sftp on foo/file.avi` will be passed. This will

 * only work if a set of suitable GIO extensions (such as gvfs 2.26

 * compiled with FUSE support), is available and operational; if this

 * is not the case, the URI will be passed unmodified to the application.

 * Some URIs, such as `mailto:`, of course cannot be mapped to a POSIX

 * path (in gvfs there's no FUSE mount for it); such URIs will be

 * passed unmodified to the application.

 *

 * Specifically for gvfs 2.26 and later, the POSIX URI will be mapped

 * back to the GIO URI in the #GFile constructors (since gvfs

 * implements the #GVfs extension point). As such, if the application

 * needs to examine the URI, it needs to use g_file_get_uri() or

 * similar on #GFile. In other words, an application cannot assume

 * that the URI passed to e.g. g_file_new_for_commandline_arg() is

 * equal to the result of g_file_get_uri(). The following snippet

 * illustrates this:

 *

 * |[ 

 * GFile *f;

 * char *uri;

 *

 * file = g_file_new_for_commandline_arg (uri_from_commandline);

 *

 * uri = g_file_get_uri (file);

 * strcmp (uri, uri_from_commandline) == 0;

 * g_free (uri);

 *

 * if (g_file_has_uri_scheme (file, "cdda"))

 *   {

 *     // do something special with uri

 *   }

 * g_object_unref (file);

 * ]|

 *

 * This code will work when both `cdda://sr0/Track 1.wav` and

 * `/home/user/.gvfs/cdda on sr0/Track 1.wav` is passed to the

 * application. It should be noted that it's generally not safe

 * for applications to rely on the format of a particular URIs.

 * Different launcher applications (e.g. file managers) may have

 * different ideas of what a given URI means.

 */

struct _GAppLaunchContextPrivate {

  char **envp;

};

typedef GAppInfoIface GAppInfoInterface;

G_DEFINE_INTERFACE (GAppInfo, g_app_info, G_TYPE_OBJECT)

static void

g_app_info_default_init (GAppInfoInterface *iface)

{

}

/**

 * g_app_info_dup:

 * @appinfo: a #GAppInfo.

 * 

 * Creates a duplicate of a #GAppInfo.

 *

 * Returns: (transfer full): a duplicate of @appinfo.

 **/

GAppInfo *

g_app_info_dup (GAppInfo *appinfo)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), NULL);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  return (* iface->dup) (appinfo);

}

/**

 * g_app_info_equal:

 * @appinfo1: the first #GAppInfo.

 * @appinfo2: the second #GAppInfo.

 *

 * Checks if two #GAppInfos are equal.

 *

 * Note that the check <emphasis>may not</emphasis> compare each individual

 * field, and only does an identity check. In case detecting changes in the 

 * contents is needed, program code must additionally compare relevant fields.

 *

 * Returns: %TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise.

 **/

gboolean

g_app_info_equal (GAppInfo *appinfo1,

		  GAppInfo *appinfo2)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo1), FALSE);

  g_return_val_if_fail (G_IS_APP_INFO (appinfo2), FALSE);

  if (G_TYPE_FROM_INSTANCE (appinfo1) != G_TYPE_FROM_INSTANCE (appinfo2))

    return FALSE;

  iface = G_APP_INFO_GET_IFACE (appinfo1);

  return (* iface->equal) (appinfo1, appinfo2);

}

/**

 * g_app_info_get_id:

 * @appinfo: a #GAppInfo.

 * 

 * Gets the ID of an application. An id is a string that

 * identifies the application. The exact format of the id is

 * platform dependent. For instance, on Unix this is the

 * desktop file id from the xdg menu specification.

 *

 * Note that the returned ID may be %NULL, depending on how

 * the @appinfo has been constructed.

 *

 * Returns: a string containing the application's ID.

 **/

const char *

g_app_info_get_id (GAppInfo *appinfo)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), NULL);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  return (* iface->get_id) (appinfo);

}

/**

 * g_app_info_get_name:

 * @appinfo: a #GAppInfo.

 * 

 * Gets the installed name of the application. 

 *

 * Returns: the name of the application for @appinfo.

 **/

const char *

g_app_info_get_name (GAppInfo *appinfo)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), NULL);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  return (* iface->get_name) (appinfo);

}

/**

 * g_app_info_get_display_name:

 * @appinfo: a #GAppInfo.

 *

 * Gets the display name of the application. The display name is often more

 * descriptive to the user than the name itself.

 *

 * Returns: the display name of the application for @appinfo, or the name if

 * no display name is available.

 *

 * Since: 2.24

 **/

const char *

g_app_info_get_display_name (GAppInfo *appinfo)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), NULL);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  if (iface->get_display_name == NULL)

    return (* iface->get_name) (appinfo);

  return (* iface->get_display_name) (appinfo);

}

/**

 * g_app_info_get_description:

 * @appinfo: a #GAppInfo.

 * 

 * Gets a human-readable description of an installed application.

 *

 * Returns: a string containing a description of the 

 * application @appinfo, or %NULL if none. 

 **/

const char *

g_app_info_get_description (GAppInfo *appinfo)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), NULL);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  return (* iface->get_description) (appinfo);

}

/**

 * g_app_info_get_executable:

 * @appinfo: a #GAppInfo

 * 

 * Gets the executable's name for the installed application.

 *

 * Returns: (type filename): a string containing the @appinfo's application

 * binaries name

 **/

const char *

g_app_info_get_executable (GAppInfo *appinfo)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), NULL);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  return (* iface->get_executable) (appinfo);

}

/**

 * g_app_info_get_commandline:

 * @appinfo: a #GAppInfo

 * 

 * Gets the commandline with which the application will be

 * started.  

 *

 * Returns: (type filename): a string containing the @appinfo's commandline,

 *     or %NULL if this information is not available

 *

 * Since: 2.20

 **/

const char *

g_app_info_get_commandline (GAppInfo *appinfo)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), NULL);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  if (iface->get_commandline)

    return (* iface->get_commandline) (appinfo);

  return NULL;

}

/**

 * g_app_info_set_as_default_for_type:

 * @appinfo: a #GAppInfo.

 * @content_type: the content type.

 * @error: a #GError.

 * 

 * Sets the application as the default handler for a given type.

 *

 * Returns: %TRUE on success, %FALSE on error.

 **/

gboolean

g_app_info_set_as_default_for_type (GAppInfo    *appinfo,

				    const char  *content_type,

				    GError     **error)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE);

  g_return_val_if_fail (content_type != NULL, FALSE);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  return (* iface->set_as_default_for_type) (appinfo, content_type, error);

}

/**

 * g_app_info_set_as_last_used_for_type:

 * @appinfo: a #GAppInfo.

 * @content_type: the content type.

 * @error: a #GError.

 *

 * Sets the application as the last used application for a given type.

 * This will make the application appear as first in the list returned

 * by g_app_info_get_recommended_for_type(), regardless of the default

 * application for that content type.

 *

 * Returns: %TRUE on success, %FALSE on error.

 **/

gboolean

g_app_info_set_as_last_used_for_type (GAppInfo    *appinfo,

                                      const char  *content_type,

                                      GError     **error)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE);

  g_return_val_if_fail (content_type != NULL, FALSE);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  return (* iface->set_as_last_used_for_type) (appinfo, content_type, error);

}

/**

 * g_app_info_set_as_default_for_extension:

 * @appinfo: a #GAppInfo.

 * @extension: (type filename): a string containing the file extension

 *     (without the dot).

 * @error: a #GError.

 * 

 * Sets the application as the default handler for the given file extension.

 *

 * Returns: %TRUE on success, %FALSE on error.

 **/

gboolean

g_app_info_set_as_default_for_extension (GAppInfo    *appinfo,

					 const char  *extension,

					 GError     **error)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE);

  g_return_val_if_fail (extension != NULL, FALSE);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  if (iface->set_as_default_for_extension)

    return (* iface->set_as_default_for_extension) (appinfo, extension, error);

  g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED,

                       "g_app_info_set_as_default_for_extension not supported yet");

  return FALSE;

}

/**

 * g_app_info_add_supports_type:

 * @appinfo: a #GAppInfo.

 * @content_type: a string.

 * @error: a #GError.

 * 

 * Adds a content type to the application information to indicate the 

 * application is capable of opening files with the given content type.

 *

 * Returns: %TRUE on success, %FALSE on error.

 **/

gboolean

g_app_info_add_supports_type (GAppInfo    *appinfo,

			      const char  *content_type,

			      GError     **error)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE);

  g_return_val_if_fail (content_type != NULL, FALSE);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  if (iface->add_supports_type)

    return (* iface->add_supports_type) (appinfo, content_type, error);

  g_set_error_literal (error, G_IO_ERROR, 

                       G_IO_ERROR_NOT_SUPPORTED, 

                       "g_app_info_add_supports_type not supported yet");

  return FALSE;

}

/**

 * g_app_info_can_remove_supports_type:

 * @appinfo: a #GAppInfo.

 * 

 * Checks if a supported content type can be removed from an application.

 *

 * Returns: %TRUE if it is possible to remove supported 

 *     content types from a given @appinfo, %FALSE if not.

 **/

gboolean

g_app_info_can_remove_supports_type (GAppInfo *appinfo)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  if (iface->can_remove_supports_type)

    return (* iface->can_remove_supports_type) (appinfo);

  return FALSE;

}

/**

 * g_app_info_remove_supports_type:

 * @appinfo: a #GAppInfo.

 * @content_type: a string.

 * @error: a #GError.

 *

 * Removes a supported type from an application, if possible.

 * 

 * Returns: %TRUE on success, %FALSE on error.

 **/

gboolean

g_app_info_remove_supports_type (GAppInfo    *appinfo,

				 const char  *content_type,

				 GError     **error)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE);

  g_return_val_if_fail (content_type != NULL, FALSE);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  if (iface->remove_supports_type)

    return (* iface->remove_supports_type) (appinfo, content_type, error);

  g_set_error_literal (error, G_IO_ERROR, 

                       G_IO_ERROR_NOT_SUPPORTED, 

                       "g_app_info_remove_supports_type not supported yet");

  return FALSE;

}

/**

 * g_app_info_get_supported_types:

 * @appinfo: a #GAppInfo that can handle files

 *

 * Retrieves the list of content types that @app_info claims to support.

 * If this information is not provided by the environment, this function

 * will return %NULL.

 * This function does not take in consideration associations added with

 * g_app_info_add_supports_type(), but only those exported directly by

 * the application.

 *

 * Returns: (transfer none) (array zero-terminated=1) (element-type utf8):

 *    a list of content types.

 *

 * Since: 2.34

 */

const char **

g_app_info_get_supported_types (GAppInfo *appinfo)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), NULL);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  if (iface->get_supported_types)

    return iface->get_supported_types (appinfo);

  else

    return NULL;

}

/**

 * g_app_info_get_icon:

 * @appinfo: a #GAppInfo.

 * 

 * Gets the icon for the application.

 *

 * Returns: (transfer none): the default #GIcon for @appinfo or %NULL

 * if there is no default icon.

 **/

GIcon *

g_app_info_get_icon (GAppInfo *appinfo)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), NULL);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  return (* iface->get_icon) (appinfo);

}

/**

 * g_app_info_launch:

 * @appinfo: a #GAppInfo

 * @files: (nullable) (element-type GFile): a #GList of #GFile objects

 * @context: (nullable): a #GAppLaunchContext or %NULL

 * @error: a #GError

 * 

 * Launches the application. Passes @files to the launched application

 * as arguments, using the optional @context to get information

 * about the details of the launcher (like what screen it is on).

 * On error, @error will be set accordingly.

 *

 * To launch the application without arguments pass a %NULL @files list.

 *

 * Note that even if the launch is successful the application launched

 * can fail to start if it runs into problems during startup. There is

 * no way to detect this.

 *

 * Some URIs can be changed when passed through a GFile (for instance

 * unsupported URIs with strange formats like mailto:), so if you have

 * a textual URI you want to pass in as argument, consider using

 * g_app_info_launch_uris() instead.

 *

 * The launched application inherits the environment of the launching

 * process, but it can be modified with g_app_launch_context_setenv()

 * and g_app_launch_context_unsetenv().

 *

 * On UNIX, this function sets the `GIO_LAUNCHED_DESKTOP_FILE`

 * environment variable with the path of the launched desktop file and

 * `GIO_LAUNCHED_DESKTOP_FILE_PID` to the process id of the launched

 * process. This can be used to ignore `GIO_LAUNCHED_DESKTOP_FILE`,

 * should it be inherited by further processes. The `DISPLAY` and

 * `DESKTOP_STARTUP_ID` environment variables are also set, based

 * on information provided in @context.

 *

 * Returns: %TRUE on successful launch, %FALSE otherwise.

 **/

gboolean

g_app_info_launch (GAppInfo           *appinfo,

		   GList              *files,

		   GAppLaunchContext  *launch_context,

		   GError            **error)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  return (* iface->launch) (appinfo, files, launch_context, error);

}

/**

 * g_app_info_supports_uris:

 * @appinfo: a #GAppInfo.

 * 

 * Checks if the application supports reading files and directories from URIs.

 *

 * Returns: %TRUE if the @appinfo supports URIs.

 **/

gboolean

g_app_info_supports_uris (GAppInfo *appinfo)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  return (* iface->supports_uris) (appinfo);

}

/**

 * g_app_info_supports_files:

 * @appinfo: a #GAppInfo.

 * 

 * Checks if the application accepts files as arguments.

 *

 * Returns: %TRUE if the @appinfo supports files.

 **/

gboolean

g_app_info_supports_files (GAppInfo *appinfo)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  return (* iface->supports_files) (appinfo);

}

/**

 * g_app_info_launch_uris:

 * @appinfo: a #GAppInfo

 * @uris: (nullable) (element-type utf8): a #GList containing URIs to launch.

 * @context: (nullable): a #GAppLaunchContext or %NULL

 * @error: a #GError

 * 

 * Launches the application. This passes the @uris to the launched application

 * as arguments, using the optional @context to get information

 * about the details of the launcher (like what screen it is on).

 * On error, @error will be set accordingly.

 *

 * To launch the application without arguments pass a %NULL @uris list.

 *

 * Note that even if the launch is successful the application launched

 * can fail to start if it runs into problems during startup. There is

 * no way to detect this.

 *

 * Returns: %TRUE on successful launch, %FALSE otherwise.

 **/

gboolean

g_app_info_launch_uris (GAppInfo           *appinfo,

			GList              *uris,

			GAppLaunchContext  *launch_context,

			GError            **error)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  return (* iface->launch_uris) (appinfo, uris, launch_context, error);

}

/**

 * g_app_info_should_show:

 * @appinfo: a #GAppInfo.

 *

 * Checks if the application info should be shown in menus that 

 * list available applications.

 * 

 * Returns: %TRUE if the @appinfo should be shown, %FALSE otherwise.

 **/

gboolean

g_app_info_should_show (GAppInfo *appinfo)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  return (* iface->should_show) (appinfo);

}

static gboolean

launch_default_for_uri (const char         *uri,

                        GAppLaunchContext  *context,

                        GError            **error)

{

  char *uri_scheme;

  GAppInfo *app_info = NULL;

  GList l;

  gboolean res;

  /* g_file_query_default_handler() calls

   * g_app_info_get_default_for_uri_scheme() too, but we have to do it

   * here anyway in case GFile can't parse @uri correctly.

   */

  uri_scheme = g_uri_parse_scheme (uri);

  if (uri_scheme && uri_scheme[0] != '\0')

    app_info = g_app_info_get_default_for_uri_scheme (uri_scheme);

  g_free (uri_scheme);

  if (!app_info)

    {

      GFile *file;

      file = g_file_new_for_uri (uri);

      app_info = g_file_query_default_handler (file, NULL, error);

      g_object_unref (file);

    }

  if (app_info == NULL)

    return FALSE;

  l.data = (char *)uri;

  l.next = l.prev = NULL;

  res = g_app_info_launch_uris (app_info, &l, context, error);

  g_object_unref (app_info);

  return res;

}

/**

 * g_app_info_launch_default_for_uri:

 * @uri: the uri to show

 * @context: (nullable): an optional #GAppLaunchContext

 * @error: (nullable): return location for an error, or %NULL

 *

 * Utility function that launches the default application

 * registered to handle the specified uri. Synchronous I/O

 * is done on the uri to detect the type of the file if

 * required.

 * 

 * Returns: %TRUE on success, %FALSE on error.

 **/

gboolean

g_app_info_launch_default_for_uri (const char         *uri,

				   GAppLaunchContext  *launch_context,

				   GError            **error)

{

  if (launch_default_for_uri (uri, launch_context, error))

    return TRUE;

#ifdef G_OS_UNIX

  if (glib_should_use_portal ())

    {

      const char *parent_window = NULL;

      /* Reset any error previously set by launch_default_for_uri */

      g_clear_error (error);

      if (launch_context && launch_context->priv->envp)

        parent_window = g_environ_getenv (launch_context->priv->envp, "PARENT_WINDOW_ID");

      return g_openuri_portal_open_uri (uri, parent_window, error);

    }

#endif

  return FALSE;

}

/**

 * g_app_info_launch_default_for_uri_async:

 * @uri: the uri to show

 * @context: (nullable): an optional #GAppLaunchContext

 * @cancellable: (nullable): a #GCancellable

 * @callback: (nullable): a #GASyncReadyCallback to call when the request is done

 * @user_data: (nullable): data to pass to @callback

 *

 * Async version of g_app_info_launch_default_for_uri().

 *

 * This version is useful if you are interested in receiving

 * error information in the case where the application is

 * sandboxed and the portal may present an application chooser

 * dialog to the user.

 *

 * Since: 2.50

 */

void

g_app_info_launch_default_for_uri_async (const char          *uri,

                                         GAppLaunchContext   *context,

                                         GCancellable        *cancellable,

                                         GAsyncReadyCallback  callback,

                                         gpointer             user_data)

{

  gboolean res;

  GError *error = NULL;

  GTask *task;

  res = launch_default_for_uri (uri, context, &error);

#ifdef G_OS_UNIX

  if (!res && glib_should_use_portal ())

    {

      const  char *parent_window = NULL;

      if (context && context->priv->envp)

        parent_window = g_environ_getenv (context->priv->envp, "PARENT_WINDOW_ID");

      g_openuri_portal_open_uri_async (uri, parent_window, cancellable, callback, user_data);

      return;

    }

#endif

  task = g_task_new (context, cancellable, callback, user_data);

  if (!res)

    g_task_return_error (task, error);

  else

    g_task_return_boolean (task, TRUE);

  g_object_unref (task);

}

/**

 * g_app_info_launch_default_for_uri_finish:

 * @result: a #GAsyncResult

 * @error: (nullable): return location for an error, or %NULL

 *

 * Finishes an asynchronous launch-default-for-uri operation.

 *

 * Returns: %TRUE if the launch was successful, %FALSE if @error is set

 *

 * Since: 2.50

 */

gboolean

g_app_info_launch_default_for_uri_finish (GAsyncResult  *result,

                                          GError       **error)

{

#ifdef G_OS_UNIX

  return g_openuri_portal_open_uri_finish (result, error);

#else

  return g_task_propagate_boolean (G_TASK (result), error);

#endif

}

/**

 * g_app_info_can_delete:

 * @appinfo: a #GAppInfo

 *

 * Obtains the information whether the #GAppInfo can be deleted.

 * See g_app_info_delete().

 *

 * Returns: %TRUE if @appinfo can be deleted

 *

 * Since: 2.20

 */

gboolean

g_app_info_can_delete (GAppInfo *appinfo)

{

  GAppInfoIface *iface;

  g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE);

  iface = G_APP_INFO_GET_IFACE (appinfo);

  if (iface->can_delete)

    return (* iface->can_delete) (appinfo);

  return FALSE; 

}

/**

 * g_app_info_delete:

 * @appinfo: a #GAppInfo

 *

 * Tries to delete a #GAppInfo.

 *

 * On some platforms, there may be a difference between user-defined

 * #GAppInfos which can be deleted, and system-wide ones which cannot.

 * See g_app_info_can_delete().

 *

 * Virtual: do_delete

 * Returns: %TRUE if @appinfo has been deleted

 *