UlAddRef

The UlAddRef function provides an alternative way to invoke the OLE method IUnknown::AddRef.

Note This function may not be supported in future versions of MAPI.

Quick Info

Header file: MAPIUTIL.H
Implemented by: MAPI
Called by: Client applications and service providers

ULONG UlAddRef(
  LPVOID punk  
);
 

Parameters

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

Return Values

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 UlAddRef function generates less code than the AddRef method and can be used in situations requiring a minimum of code.

UlAddRef returns the value returned by the IUnknown::AddRef method, which is the new value of the reference count for the interface. The value is nonzero.

For more information on IUnknown::AddRef, see Implementing the IUnknown Interface.

See Also

IUnknown Functions