虚拟方法

GioFileIOStreamquery_info

自2.22以来

声明 [src]

GFileInfo*
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 返回。

如果流已经关闭（错误设置为 G_IO_ERROR_CLOSED），流有挂起的操作（错误设置为 G_IO_ERROR_PENDING），或者如果查询信息不被流接口支持（错误设置为 G_IO_ERROR_NOT_SUPPORTED），可能会失败。在所有失败的情况下，将返回 NULL。

如果 cancellable 不是 NULL，则可以从其他线程触发可取消对象以取消操作。如果操作被取消，将设置错误 G_IO_ERROR_CANCELLED，并且返回 NULL。

自2.22以来可用

参数

attributes

类型： const char*

文件属性查询字符串。

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

值是一个以 NUL 结尾的 UTF-8 字符串。

cancellable

类型： GCancellable

可选的 GCancellable 对象，NULL 表示忽略。

参数可以是 NULL。

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

error

类型： GError **

恢复错误的位置。

参数可以是 NULL。

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

如果没有错误，虚拟函数会将参数保留初始化为 NULL。

发生错误时，参数将被设置为一个新的 GError；调用者将拥有数据，并负责释放它。

返回值

类型： GFileInfo

流的 GFileInfo，或错误时返回 NULL。

方法的调用者拥有返回的数据，并负责释放它。