方法
GioFileOutputStreamquery_info
声明 [src]
GFileInfo*
g_file_output_stream_query_info (
GFileOutputStream* stream,
const char* attributes,
GCancellable* cancellable,
GError** error
)
描述 [src]
查询给定 attributes
的文件输出流。此函数在查询流时将被阻塞。关于该函数的异步版本,请参阅 g_file_output_stream_query_info_async()。当流被阻塞时,流会在内部设置挂起标志,并且流上的任何其他操作都将因 G_IO_ERROR_PENDING
而失败。
如果流已关闭(error
被设置为 G_IO_ERROR_CLOSED
),流有挂起操作(error
被设置为 G_IO_ERROR_PENDING
),或者不支持流接口上的查询信息(error
被设置为 G_IO_ERROR_NOT_SUPPORTED
),则可能会失败。在所有失败的情况下,都将返回 NULL
。
如果 cancellable
不是 NULL
,则可以通过从另一个线程触发可取消对象来取消操作。如果操作被取消,则错误设置为 G_IO_ERROR_CANCELLED
,并且返回 NULL
。
参数
attributes
-
类型:
const char*
文件属性查询字符串。
数据由方法调用者拥有。 值是空终止的 UTF-8 字符串。 cancellable
-
类型:
GCancellable
可选的
GCancellable
对象,NULL
表示忽略。该参数可以是 NULL
。数据由方法调用者拥有。 error
-
类型:
GError **
恢复错误的返回位置。
该参数可以是 NULL
。如果返回位置不是 NULL
,则必须将其初始化为NULL
GError*
。如果没有错误,方法将通过将其初始化为 NULL
来保留该参数。在出错的情况下,该参数将被设置为一个新的 GError
;调用者将接管数据的所有权,并负责释放它。
返回值
类型: GFileInfo
对于 stream
的 GFileInfo
,或者在出错时返回 NULL
。
方法的调用者接管返回的数据的所有权,并负责释放它。 |