方法
GLibBookmarkFileget_app_info
已弃用:2.66 自:2.12
声明 [源码]
gboolean
g_bookmark_file_get_app_info (
GBookmarkFile* bookmark,
const gchar* uri,
const gchar* name,
gchar** exec,
guint* count,
time_t* stamp,
GError** error
)
描述 [源码]
获取对_bookmark 为uri
的应用程序的注册信息app_name
。有关返回数据的更多信息,请参阅g_bookmark_file_set_application_info
。
app_exec
中返回的字符串必须释放。
如果无法找到URI
,则返回FALSE
,并将error
设置为G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND
。如果没有名为app_name
的应用程序为uri
注册了书签,则返回FALSE
并设置错误为G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED
。如果解引命令行失败,则设置一个名为G_SHELL_ERROR
的域错误,并返回FALSE
。
自:2.12
自:2.66
请使用 g_bookmark_file_get_application_info()
,因为由于2038年问题,time_t
已废弃。
参数
uri
-
类型:
const gchar*
有效的 URI。
数据由方法的调用者拥有。 该值是一个NUL终止的UTF-8字符串。 name
-
类型:
const gchar*
应用程序的名称。
数据由方法的调用者拥有。 该值是一个NUL终止的UTF-8字符串。 exec
-
类型:
gchar**
返回应用程序的命令行位置,或
NULL
。参数将由函数设置。 参数可以是 NULL
。方法调用者将获得返回数据的拥有权,并负责释放它。 该值是一个NUL终止的UTF-8字符串。 count
-
类型:
guint*
返回注册计数的位置,或
NULL
。参数将由函数设置。 参数可以是 NULL
。 stamp
-
类型:
time_t*
返回最后注册时间的位置,或
NULL
。参数将由函数设置。 参数可以是 NULL
。方法调用者将获得返回数据的拥有权,并负责释放它。 error
-
类型:
GError **
恢复性错误的返回位置。
参数可以是 NULL
。如果返回位置不是 NULL
,则必须将其初始化为一个NULL
的GError*
。如果没有错误,方法将保留初始化的参数为 NULL
。如果出现错误,参数将设置为一个新分配的 GError
;调用者将获得数据的拥有权,并负责释放数据。