query_single_entry


Description:

[ Version ( since = "0.9.0" ) ]
public Entry query_single_entry (AuthorizationDomain? domain, string entry_id, Query? query, Type entry_type, Cancellable? cancellable = null) throws Error

Retrieves information about the single entry with the given entry_id.

entry_id should be as returned by get_id.

Parameters and errors are as for query. Most of the properties of query aren't relevant, and will cause a server-side error if used. The most useful property to use is etag, which will cause the server to not return anything if the entry hasn't been modified since it was given the specified ETag; thus saving bandwidth. If the server does not return anything for this reason, query_single_entry will return null, but will not set an error in error.

Parameters:

this

a Service

domain

the AuthorizationDomain the query falls under, or null

entry_id

the entry ID of the desired entry

query

a Query with the query parameters, or null

entry_type

a Type for the Entry to build from the XML

cancellable

a Cancellable, or null

Returns:

a Entry, or null; unref with unref