Method
GckObjectcache_lookup
Declaration [src]
GckAttributes*
gck_object_cache_lookup (
GckObject* object,
const gulong* attr_types,
gint n_attr_types,
GCancellable* cancellable,
GError** error
)
Description [src]
Lookup attributes in the cache, or retrieve them from the object if necessary.
If object
is a GckObjectCache
then this will lookup the attributes there
first if available, otherwise will read them from the object and update
the cache.
If object
is not a GckObjectCache
, then the attributes will simply be
read from the object.
This may block, use the asynchronous version when this is not desirable.
Parameters
attr_types
-
Type: An array of
gulong
The types of attributes to update.
The length of the array is specified in the n_attr_types
argument.The data is owned by the caller of the method. n_attr_types
-
Type:
gint
The number of attribute types.
cancellable
-
Type:
GCancellable
Optional cancellation object.
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 aNULL
GError*
.The argument will be left initialized to NULL
by the method 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: GckAttributes
The attributes retrieved or NULL
on failure.
The caller of the method takes ownership of the returned data, and is responsible for freeing it. |