方法
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
,那么您必须将其初始化为一个NULL
GError*
。如果没有错误,方法将保留参数初始化为 NULL
。如果有错误,参数将设置为一个新的 GError
;调用者将获得数据的所有权,并负责释放它。