Platform SDK: MAPI |
The UlRelease function provides an alternative way to invoke the OLE method IUnknown::Release.
Note This function may not be supported in future versions of MAPI.
Header file: | MAPIUTIL.H |
Implemented by: | MAPI |
Called by: | Client applications and service providers |
ULONG UlRelease( LPVOID punk );
The reference count is the number of existing pointers to the object to be released.
If the punk parameter is NULL, the function returns immediately without calling IUnknown::Release. This feature can save code if a client or provider declares an interface pointer and initializes it to NULL. Code is used in the method indication but saved in not testing for NULL.
UlRelease returns the value returned by the IUnknown::Release method, which can be equal to the reference count for the object to be released.
For more information on IUnknown::Release, see Implementing the IUnknown Interface.