方法

GioFileIOStreamquery_info

自 2.22 起有效

声明 [src]

GFileInfo*
g_file_io_stream_query_info (
  GFileIOStream* stream,
  const char* attributes,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

查询给定 attributes 的文件 io 流。此函数在查询流时将被阻塞。有关该函数的异步版本，请参阅 g_file_io_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。

自 2.22 起有效

参数

attributes

类型： const char*

文件属性查询字符串。

数据由方法的调用者拥有。

值是一个以空字符终止的 UTF-8 字符串。

cancellable

类型： GCancellable

可选的 GCancellable 对象，NULL 以忽略。

该参数可以是 NULL。

数据由方法的调用者拥有。

error

类型： GError **

恢复错误的返回位置。

该参数可以是 NULL。

如果返回位置不是 NULL，则您必须将其初始化为 NULL GError*。

如果没有错误，方法将把参数留空初始化为 NULL。

在发生错误的情况下，参数将被设置为新分配的 GError；调用者将承担数据的所有权，并负责释放它。

返回值

类型： GFileInfo

对于 stream 的 GFileInfo，或者在错误的情况下为 NULL。

方法的调用者将接管返回的数据的所有权，并负责释放它。