方法
GLibBookmarkFileset_app_info
已弃用:2.66 自:2.12
声明 [源]
gboolean
g_bookmark_file_set_app_info (
GBookmarkFile* bookmark,
const gchar* uri,
const gchar* name,
const gchar* exec,
gint count,
time_t stamp,
GError** error
)
描述 [源]
设置 bookmark 中已注册 uri 的应用列表中名为 name 的应用元数据。
很少需要使用此函数,请改用 g_bookmark_file_add_application() 和 g_bookmark_file_remove_application()。
name 可以是任何用于标识应用的 UTF-8 编码字符串。 exec 可以有以下两个修饰符之一:“\%f”,这会被展开为从书签的 URI 中检索到的本地文件名;“\%u”,这会被展开为书签的 URI。展开会在使用 g_bookmark_file_get_application_info() 函数检索存储的命令行时自动进行。《code>count 是应用已注册书签的次数;如果它是 < 0,当前的注册计数将增加一个,如果它是 0,带有 name 的应用将从已注册应用列表中删除。《code>stamp 是上次注册的 Unix 时间;如果它是 -1,将使用当前时间。
如果您尝试通过将注册计数设置为 0 来移除应用,并且找不到 uri 的书签,则返回 FALSE,并将 error 设置为 G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND;同样,如果没有应用 name 为 uri 注册书签,返回 FALSE,并将 error 设置为 G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED。否则,如果在 uri 中找不到书签,将创建一个新的书签。
自 2.12 版本起可用
自 2.66 版本起弃用
建议使用 g_bookmark_file_set_application_info() 代替,因为 time_t 由于 2038 年问题被弃用。
参数
uri-
类型:
const gchar*一个有效的 URI。
数据由方法的调用者拥有。 值是一个以 NUL 结尾的 UTF-8 字符串。 name-
类型:
const gchar*一个应用的名。
数据由方法的调用者拥有。 值是一个以 NUL 结尾的 UTF-8 字符串。 exec-
类型:
const gchar*一个应用的命令行。
数据由方法的调用者拥有。 值是一个以 NUL 结尾的 UTF-8 字符串。 count-
类型:
gint为此应用所做的注册次数。
stamp-
类型:
time_t为此应用进行最后一次注册的时间。
error-
类型:
GError **一个可恢复错误的返回位置。
参数可以 NULL。如果返回位置不是 NULL,那么您必须将其初始化为一个NULLGError*。如果没有错误,方法将保留参数初始化为 NULL。如果有错误,参数将设置为一个新的 GError;调用者将获得数据的所有权,并负责释放它。