虚拟方法
GioFileOutputStreamquery_info
声明 [src]
GFileInfo*
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*文件属性查询字符串。
数据由方法调用者拥有。 值是一个以 NULL 结束的 UTF-8 字符串。 cancellable-
类型:
GCancellable可选
GCancellable对象,NULL表示忽略。该参数可以是 NULL。数据由方法调用者拥有。 error-
类型:
GError **一个可恢复错误的返回位置。
该参数可以是 NULL。如果返回位置不是 NULL,那么你必须将它初始化为一个NULLGError*。如果虚拟函数没有错误,则参数将初始化为 NULL。如果出错,参数将被设置为一个新的 GError;调用者将拥有数据,并负责释放它。
返回值
类型: GFileInfo
对于 stream 的 GFileInfo,或者在出错时为 NULL。
| 方法的调用者将拥有返回的数据,并负责释放它。 |