IMAPIFormFactory Interface

IID_IMAPIFormFactory

{0002032E-0000-0000-C000-000000000046}

The IMAPIFormFactory interface supports the use of configurable run-time forms in distributed computing environments.

The IMAPIFormFactory interface is based on the OLE IClassFactory interface, and objects implementing IMAPIFormFactory should also inherit from IClassFactory. For more information on IClassFactory, see the OLE Programmer's Reference.

IMAPIFormFactory is the interface that form viewers use to create new form objects when a form server supports more than one message class that is, more than one type of form object.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IMAPIFormFactory Methods

Description

CreateClassFactory

Returns a class factory object for the form.

LockServer

Keeps an open form server in memory.

CreateClassFactory

FUNCTION IMAPIFormFactory_CreateClassFactory ( _
  BYVAL pIMAPIFormFactory AS DWORD PTR _
, BYREF clsidForm AS GUID _
, BYVAL ulFlags AS DWORD _
, BYREF lppClassFactory AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMAPIFormFactory[3] USING IMAPIFormFactory_CreateClassFactory (pIMAPIFormFactory, clsidForm, ulFlags, lppClassFactory) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

LockServer

FUNCTION IMAPIFormFactory_LockServer ( _
  BYVAL pIMAPIFormFactory AS DWORD PTR _
, BYVAL ulFlags AS DWORD _
, BYVAL fLockServer AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMAPIFormFactory[4] USING IMAPIFormFactory_LockServer (pIMAPIFormFactory, ulFlags, fLockServer) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION