 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This method decrements the reference count for the calling interface on a object. If the reference count on the object falls to 0, the object is freed from memory.
ULONG Release( void );
Return Values
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.
Remarks
If IUnknown::AddRefhas been called on this object's interface ntimes and this is the n+1thcall to IUnknown::Release, the implementation of IUnknown::AddRefmust 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.
Notes to Callers
Call this function when you no longer need to use an interface pointer. If you are writing a function that takes an in-out parameter, call IUnknown::Releaseon the pointer you are passing in before copying the out-value on top of it.
Requirements
| Runs On | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 1.0 and later | Unknwn.h |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also