ValidateParms

Applies to: Office 2010 | Outlook 2010 | Visual Studio

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

Header file:

Mapival.h

Implemented by:

MAPI

Called by:

Service providers

HRESULT ValidateParms(
  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
    All of the parameters are valid.

  • MAPI_E_CALL_FAILED
    One or more of the parameters are not valid.

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.

ValidateParms is called differently depending on whether the calling code is C or C++. C++ passes an implicit parameter known as this to each method call, which becomes explicit in C and is the address of the object. The first parameter, eMethod, is an enumerator made from the interface and method being validated and tells what parameters to expect to find on the stack. The second parameter is different for C and C++. In C++ it is called First, and it is the first parameter to the method being validated. The second parameter for the C language, ppThis, is the address of the first parameter to the method which is always an object pointer. In both cases, the second parameter gives the address of the beginning of the method's parameter list, and based on eMethod, moves down the stack and validates the parameters.

Providers implementing common interfaces such as IMAPITable and IMAPIProp should always check parameters using the ValidateParms function in order to make sure consistency across all providers. Additional parameter validation functions have been defined for some complex parameter types to be used instead as appropriate. See the reference topics for the following functions:

Inherited methods use the same parameter validation as the interface from which they inherit. For example, the parameter checking for IMessage and IMAPIProp should be the same.

See Also

Reference

UlValidateParms