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