Share via


FormFactory

4/8/2010

The FormFactory function must be implemented to return a reference to the IFormProvider interface, which allows the Microsoft Messaging Application to create the plug-in's custom read and compose forms. The FORMFACTORYFUNC type defines a pointer to this function.

Note

The FormFactory function is available only on Pocket PC 2002 and Smartphone 2002. For Windows Mobile 2003 and later, use the FormFactoryEx function.

Syntax

HRESULT FormFactory (
  LPCWSTR pszMsgClass,
  IFormProvider ** ppObj,
);

Parameters

  • pszMsgClass
    [in] Reference to the message's message class property.
  • ppObj
    [out] Reference to the plug-in's IFormProvider interface. Returns NULL if pszMsgClass is valid but the object cannot be created.

Return Value

This function returns an appropriate HRESULT value, such as the following:

  • S_OK
    The function successfully returned a reference to the IFormProvider interface.
  • MAPI_E_INVALID_PARAMETER
    The input parameter is NULL.
  • MAPI_E_NOT_ENOUGH_MEMORY
    A memory allocation failed.

Requirements

Header cemapi.h
Library cemapi.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

MAPI Functions

Other Resources

Messaging