UlAddRef

  • Article

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 page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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

Header file:

Mapidefs.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 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

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