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 |
|
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 |
|
The caller of the method takes ownership of the data, and is responsible for freeing it. |