UlValidateParms

Applies to: Outlook 2013 | Outlook 2016

Calls an internal function to check the parameters client applications have passed to service providers and MAPI.

Property Value
Header file:
Mapival.h
Implemented by:
MAPI
Called by:
Service providers
HRESULT UlValidateParms(
  METHODS eMethod,
  LPVOID First
);

Parameters

eMethod

[in] Specifies, by enumeration, the method to validate.

First

[in] Pointer to the first argument on the stack.

Return value

S_OK

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

MAPI_E_CALL_FAILED

An error prevented the operation from completing.

Remarks

Parameters passed between MAPI and service providers are assumed to be correct and undergo only debug validation with the CheckParms macro. Providers should check all parameters passed in by client applications, but clients should assume that MAPI and provider parameters are correct. Use the HR_FAILED macro to test return values.

The UlValidateParms macro is called differently depending on whether the calling code is C or C++. This macro is used to validate parameters for the few IUnknown and MAPI methods that return ULONG instead of HRESULT values; the ValidateParms macro works for all others.