Share via

UlRelease

  • Article

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Provides an alternative way to invoke the OLE method IUnknown::Release.

Header file:

Mapidefs.h

Implemented by:

MAPI

Called by:

Client applications and service providers

 
ULONG UlRelease(
  LPVOID punk
);

Parameters

  • punk
    [in] Pointer to an interface derived from the IUnknown interface, in other words any MAPI interface.

Return Value

  • S_OK
    The call succeeded and has returned the expected value or values.

  • MAPI_E_CALL_FAILED
    An error of unexpected or unknown origin prevented the operation from completing.

Remarks

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

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 about IUnknown::Release, see Implementing the IUnknown Interface.