函数
声明 [源]
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
)
描述 [源]
此函数执行与 g_app_info_launch_uris()
相当的操作,但主要面向用于启动应用程序的操作系统组件。普通应用程序应使用 g_app_info_launch_uris()
。
如果应用程序通过 GSpawn 启动,则使用 spawn_flags
、user_setup
和 user_setup_data
调用 g_spawn_async()
。此外,还会调用 pid_callback
(带有 pid_callback_data
)以通知创建的进程的 PID。有关可以启用优化 posix_spawn()
代码路径的一定参数条件的更多信息,请参阅 g_spawn_async_with_pipes()
。
如果应用程序的启动是通过某种其他机制(例如,D-Bus 激活)进行的,则忽略 spawn_flags
、user_setup
、user_setup_data
、pid_callback
和 pid_callback_data
。
参数
appinfo
-
类型:
GDesktopAppInfo
一个
GDesktopAppInfo
。数据由函数的调用者拥有。 uris
-
类型: UTF-8 字符串列表
URI 列表。
数据由函数的调用者拥有。 每个元素都是一个以 NUL 结尾的 UTF-8 字符串。 launch_context
-
参数可以是 NULL
。数据由函数的调用者拥有。 spawn_flags
-
类型:
GSpawnFlags
GSpawnFlags
,用于每个进程。 user_setup
-
一个
GSpawnChildSetupFunc
,对于每个进程只使用一次。 user_setup_data
-
类型:
gpointer
user_setup
的用户数据。参数可以是 NULL
。数据由函数的调用者拥有。 pid_callback
-
子进程的回调。
pid_callback_data
-
类型:
gpointer
callback
的用户数据。参数可以是 NULL
。数据由函数的调用者拥有。 error
-
类型:
GError **
用于恢复错误的位置。
参数可以是 NULL
。如果返回位置不是 NULL
,那么您必须将其初始化为空的GError*
。如果没有错误,函数将使参数初始化为 NULL
。如果出现错误,参数将设置为新分配的 GError
;调用者将拥有数据的所有权,并负责释放它。