方法

GioAppLaunchContextget_startup_notify_id

声明 [src]

char*
g_app_launch_context_get_startup_notify_id (
  GAppLaunchContext* context,
  GAppInfo* info,
  GList* files
)

描述 [src]

启动应用的通知，并返回启动操作支持的 XDG_ACTIVATION_TOKEN 或 DESKTOP_STARTUP_ID。

返回的令牌可以等价地称为“激活令牌”（使用 Wayland 术语）或“启动序列 ID”（使用 X11 术语）。这两种 是可互操作的。

激活令牌定义在 XDG 激活协议 中，启动通知 ID 定义在 freedesktop.org 启动通知协议 中。

XDG 激活协议的支持添加在 GLib 2.76 中。自 GLib 2.82 以来，info 和 files 可以是 NULL。如果后端不支持，则返回的令牌将是 NULL。

参数

info

类型： GAppInfo

应用信息。

参数可以是 NULL。
数据由方法调用者拥有。
files

类型： 一个空的列表

一组 GFile 对象。

参数可以是 NULL。
数据由方法调用者拥有。

返回值

类型： char*

应用的启动通知 ID，如果不支持则返回 NULL。

方法调用者将接收返回数据的所有权，并负责释放它。
返回值可以是 NULL。
该值是一个以 NUL 结尾的 UTF-8 字符串。