get_data_sync
Description:
Reads a resource identified by uri
from the server.
The URI cannot reference a collection.
The out_bytes
is filled by actual data being read. If not null
, out_length
is populated with how many
bytes had been read. The out_bytes
is always NUL-terminated, while this termination byte is not part of out_length
.
Free the out_bytes
with g_free, when no longer needed.
Free returned pointer of out_href
and out_etag
, if not null
, with
g_free, when no longer needed.
The optional out_headers
contains response headers. Free it with soup_message_headers_free
, when no longer needed.
To read large data use get_sync instead.
Parameters:
this | |
uri |
URI of the resource to read |
out_href |
optional return location for href of the resource, or |
out_etag |
optional return location for etag of the resource, or |
out_headers |
optional return location for response MessageHeaders, or |
out_bytes |
return location for bytes being read |
out_length |
option return location for length of bytes being read, or |
cancellable |
optional Cancellable object, or |
Returns:
Whether succeeded. |