方法
自:2.66
声明 [源代码]
gboolean
g_bookmark_file_get_application_info (
GBookmarkFile* bookmark,
const char* uri,
const char* name,
char** exec,
unsigned int* count,
GDateTime** stamp,
GError** error
)
描述 [源代码]
获取对书签uri
的app_name
的注册信息。有关返回数据的更多信息,请参阅g_bookmark_file_set_application_info()
。
app_exec
中返回的字符串必须释放。
如果在找不到 URI 的情况下,将返回 FALSE
并将 error
设为 G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND
。如果没有应用程序已为 uri
注册书签,将返回 FALSE
并将错误设置为 G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED
。如果取消命令行的引用失败,则设置 G_SHELL_ERROR
域的错误,并返回 FALSE
。
自:2.66
参数
uri
-
类型:
const char*
一个有效的 URI。
数据由方法的调用者所有。 该值是一个以 NUL 结尾的 UTF-8 字符串。 name
-
类型:
const char*
应用程序的名称。
数据由方法的调用者所有。 该值是一个以 NUL 结尾的 UTF-8 字符串。 exec
-
类型:
char**
返回应用程序命令行的位置,或
NULL
。参数将由函数设置。 参数可以是 NULL
。方法调用者将接管返回数据的所有权,并负责释放它。 该值是一个以 NUL 结尾的 UTF-8 字符串。 count
-
类型:
unsigned int*
返回注册计数的位置,或
NULL
。参数将由函数设置。 参数可以是 NULL
。 stamp
-
类型:
GDateTime
返回最后注册时间的位置,或
NULL
。参数将由函数设置。 参数可以是 NULL
。返回的数据由实例所有。 error
-
类型:
GError **
为可恢复错误设置的返回位置。
参数可以是 NULL
。如果返回位置不是 NULL
,则必须将其初始化为NULL
的GError*
。如果没有错误,方法将保留初始化为 NULL
的参数。出错时,参数将被设置为一个新的 GError
;调用者将接管数据的所有权,并负责释放它。