Export (0) Print
Expand All
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IUnknown::Release

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

This method decrements the reference count for the calling interface on a object. If the reference count on the object falls to zero, the object is freed from memory.


ULONG Release(void);

None.

Returns the resulting value of the reference count, which is used for diagnostic/testing purposes only. If you need to know that resources have been freed, use an interface with higher-level semantics.

If the IUnknown::AddRef method has been called on this object's interface n times and this is the n+1 call to IUnknown::Release, the implementation of IUnknown::AddRef must cause the interface pointer to free itself.

When the released pointer is the only existing reference to an object (whether the object supports single or multiple interfaces), the implementation must free the object.

Aggregation of objects restricts the ability to recover interface pointers.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Notes to Callers

Call this method when you no longer need to use an interface pointer. If you are writing a function that takes an in-out parameter, call IUnknown::Release on the pointer you are passing in before copying the out-value on top of it.

Headerunknwn.h, unknwn.idl
Libraryole32.lib, uuid.lib
Windows Embedded CEWindows CE 1.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

Show:
© 2015 Microsoft