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.