Method

GioFileOutputStreamquery_info

Declaration

GFileInfo*
g_file_output_stream_query_info (
  GFileOutputStream* stream,
  const char* attributes,
  GCancellable* cancellable,
  GError** error
)

Description

Queries a file output stream for the given attributes. This function blocks while querying the stream. For the asynchronous version of this function, see g_file_output_stream_query_info_async(). While the stream is blocked, the stream will set the pending flag internally, and any other operations on the stream will fail with G_IO_ERROR_PENDING.

Can fail if the stream was already closed (with error being set to G_IO_ERROR_CLOSED), the stream has pending operations (with error being set to G_IO_ERROR_PENDING), or if querying info is not supported for the stream’s interface (with error being set to G_IO_ERROR_NOT_SUPPORTED). In all cases of failure, NULL will be returned.

If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be set, and NULL will be returned.

Parameters

`attributes`	`const char*`
	A file attribute query string.
	The data is owned by the caller of the function.
	The value is a NUL terminated UTF-8 string.
`cancellable`	`GCancellable`
	Optional `GCancellable` object, `NULL` to ignore.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
`error`	`GError **`
	The return location for a `GError*`, or `NULL`.

Return value

Returns:	`GFileInfo`
	A `GFileInfo` for the `stream`, or `NULL` on error.
	The caller of the method takes ownership of the data, and is responsible for freeing it.