Method
GioDesktopAppInfolaunch_uris_as_manager
Declaration [src]
gboolean
g_desktop_app_info_launch_uris_as_manager (
GDesktopAppInfo* appinfo,
GList* uris,
GAppLaunchContext* launch_context,
GSpawnFlags spawn_flags,
GSpawnChildSetupFunc user_setup,
gpointer user_setup_data,
GDesktopAppLaunchCallback pid_callback,
gpointer pid_callback_data,
GError** error
)
Description [src]
This function performs the equivalent of g_app_info_launch_uris()
,
but is intended primarily for operating system components that
launch applications. Ordinary applications should use
g_app_info_launch_uris()
.
If the application is launched via GSpawn, then spawn_flags
, user_setup
and user_setup_data
are used for the call to g_spawn_async()
.
Additionally, pid_callback
(with pid_callback_data
) will be called to
inform about the PID of the created process. See
g_spawn_async_with_pipes()
for information on certain parameter
conditions that can enable an optimized posix_spawn()
code path to be used.
If application launching occurs via some other mechanism (for example, D-Bus
activation) then spawn_flags
, user_setup
, user_setup_data
,
pid_callback
and pid_callback_data
are ignored.
Parameters
uris
-
Type: A list of
utf8
List of URIs.
The data is owned by the caller of the method. Each element is a NUL terminated UTF-8 string. launch_context
-
Type:
GAppLaunchContext
The argument can be NULL
.The data is owned by the caller of the method. spawn_flags
-
Type:
GSpawnFlags
GSpawnFlags
, used for each process. user_setup
-
Type:
GSpawnChildSetupFunc
A
GSpawnChildSetupFunc
, used once for each process.The argument can be NULL
. user_setup_data
-
Type:
gpointer
User data for
user_setup
.The argument can be NULL
.The data is owned by the caller of the method. pid_callback
-
Type:
GDesktopAppLaunchCallback
Callback for child processes.
The argument can be NULL
. pid_callback_data
-
Type:
gpointer
User data for
callback
.The argument can be NULL
.The data is owned by the caller of the method. error
-
Type:
GError **
The return location for a recoverable error.
The argument can be NULL
.If the return location is not NULL
, then you must initialize it to aNULL
GError*
.The argument will be left initialized to NULL
by the method if there are no errors.In case of error, the argument will be set to a newly allocated GError
; the caller will take ownership of the data, and be responsible for freeing it.