Virtual Method
GioFileIOStreamquery_info
since: 2.22
Declaration [src]
GFileInfo*
query_info (
GFileIOStream* stream,
const char* attributes,
GCancellable* cancellable,
GError** error
)
Description [src]
Queries a file io stream for the given attributes.
This function blocks while querying the stream. For the asynchronous
version of this function, see g_file_io_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). I
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.
Available since: 2.22
Parameters
attributes-
Type:
const char*A file attribute query string.
The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. cancellable-
Type:
GCancellableOptional
GCancellableobject,NULLto ignore.The argument can be NULL.The data is owned by the caller of the method. error-
Type:
GError **The return location for a recoverable error.
The argument can be NULL.If the return location is not NULL, then you must initialize it to aNULLGError*.The argument will be left initialized to NULLby the virtual function if there are no errors.In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.
Return value
Type: GFileInfo
A GFileInfo for the stream, or NULL on error.
| The caller of the method takes ownership of the returned data, and is responsible for freeing it. |