next up previous contents index
Next: 4.7.3 release: Release a Up: 4.7 oskit_iunknown: base interface Previous: 4.7.1 query: Query for

4.7.2 addref: Increment an interface's reference count

 

SYNOPSIS

#include <oskit/com.h>

OSKIT_COMDECL_U addref(oskit_iunknown_t *obj);

DESCRIPTION

This method adds one to the interface's reference count (or to the object's reference count, if the object implements only one counter for all its interfaces). A corresponding call must later be made to the release method.

PARAMETERS

obj
The interface on which to increment the reference count.

RETURNS

Returns the new reference count. This return code should only be used for debugging purposes, as its value is generally unstable at run time and its behavior depends on the object's implementation.



University of Utah Flux Research Group