IMAPIFormMgr Interface

IID_IMAPIFormMgr

{00020322-0000-0000-C000-000000000046}

The IMAPIFormMgr interface is used by form viewers to get information about and activate form servers.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IMAPIFormMgr Methods

Description

LoadForm

Launches a form to open an existing message.

ResolveMessageClass

Resolves a message class to its form within a form container and returns a form information object for that form.

ResolveMultipleMessageClasses

Resolves a group of message classes to their forms within a form container and returns an array of form information objects for those forms.

CalcFromPropSet

Returns an array of the properties used by a group of forms.

CreateForm

Launches a form to create a new message based on the form's message class.

SelectForm

Presents a dialog box that enables the user to select a form and returns a form information object describing that form.

SelectMultipleForms

Presents a dialog box that enables the user to select multiple forms and returns an array of form information objects describing those forms.

SelectFormContainer

Presents a dialog box that enables the user to select a form container and returns an interface for the container object the user selected.

OpenFormContainer

Opens an IMAPIFormContainer interface for a specific form container.

PrepareForm

Downloads a form for launching.

IsInConflict

Determines whether a form can handle its own message conflicts.

LoadForm

FUNCTION IMAPIFormMgr_LoadForm ( _
  BYVAL pIMAPIFormMgr AS DWORD PTR _
, BYVAL ulUIParam AS DWORD _
, BYVAL ulFlags AS DWORD _
, BYREF lpszMessageClass AS ASCIIZ _
, BYVAL ulMessageStatus AS DWORD _
, BYVAL ulMessageFlags AS DWORD _
, BYVAL pFolderFocus AS DWORD _
, BYVAL pMessageSite AS DWORD _
, BYVAL pmsg AS DWORD _
, BYVAL pViewContext AS DWORD _
, BYREF riid AS GUID _
, BYREF ppvObj AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMAPIFormMgr[3] USING IMAPIFormMgr_LoadForm (pIMAPIFormMgr, ulUIParam, ulFlags, lpszMessageClass, ulMessageStatus, ulMessageFlags, pFolderFocus, pMessageSite, pmsg, pViewContext, riid, ppvObj) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

ResolveMessageClass

FUNCTION IMAPIFormMgr_ResolveMessageClass ( _
  BYVAL pIMAPIFormMgr AS DWORD PTR _
, BYREF szMsgClass AS ASCIIZ _
, BYVAL ulFlags AS DWORD _
, BYVAL pFolderFocus AS DWORD _
, BYREF ppResult AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMAPIFormMgr[4] USING IMAPIFormMgr_ResolveMessageClass (pIMAPIFormMgr, szMsgClass, ulFlags, pFolderFocus, ppResult) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

ResolveMultipleMessageClasses

FUNCTION IMAPIFormMgr_ResolveMultipleMessageClasses ( _
  BYVAL pIMAPIFormMgr AS DWORD PTR _
, BYVAL pMsgClasses AS DWORD _
, BYVAL ulFlags AS DWORD _
, BYVAL pFolderFocus AS DWORD _
, BYREF ppfrminfoarray AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMAPIFormMgr[5] USING IMAPIFormMgr_ResolveMultipleMessageClasses (pIMAPIFormMgr, pMsgClasses, ulFlags, pFolderFocus, ppfrminfoarray) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

CalcFromPropSet

FUNCTION IMAPIFormMgr_CalcFormPropSet ( _
  BYVAL pIMAPIFormMgr AS DWORD PTR _
, BYVAL pfrminfoarray AS DWORD _
, BYVAL ulFlags AS DWORD _
, BYREF ppResults AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMAPIFormMgr[6] USING IMAPIFormMgr_CalcFormPropSet (pIMAPIFormMgr, pfrminfoarray, ulFlags, ppResults) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

CreateForm

FUNCTION IMAPIFormMgr_CreateForm ( _
  BYVAL pIMAPIFormMgr AS DWORD PTR _
, BYVAL ulUIParam AS DWORD _
, BYVAL ulFlags AS DWORD _
, BYVAL pfrminfoToActivate AS DWORD _
, BYREF refiidToAsk AS GUID _
, BYREF ppvObj AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMAPIFormMgr[7] USING IMAPIFormMgr_CreateForm (pIMAPIFormMgr, ulUIParam, ulFlags, pfrminfoToActivate, refiidToAsk, ppvObj) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

SelectForm

FUNCTION IMAPIFormMgr_SelectForm ( _
  BYVAL pIMAPIFormMgr AS DWORD PTR _
, BYVAL ulUIParam AS DWORD _
, BYVAL ulFlags AS DWORD _
, BYREF pszTitle AS ASCIIZ _
, BYVAL pfld AS DWORD _
, BYREF ppfrminfoReturned AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMAPIFormMgr[8] USING IMAPIFormMgr_SelectForm (pIMAPIFormMgr, ulUIParam, ulFlags, pszTitle, pfld, ppfrminfoReturned) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

SelectMultipleForms

FUNCTION IMAPIFormMgr_SelectMultipleForms ( _
  BYVAL pIMAPIFormMgr AS DWORD PTR _
, BYVAL ulUIParam AS DWORD _
, BYVAL ulFlags AS DWORD _
, BYREF pszTitle AS ASCIIZ _
, BYVAL pfld AS DWORD _
, BYVAL pfrminfoarray AS DWORD _
, BYREF ppfrminfoarray AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMAPIFormMgr[9] USING IMAPIFormMgr_SelectMultipleForms (pIMAPIFormMgr, ulUIParam, ulFlags, pszTitle, pfld, pfrminfoarray, ppfrminfoarray) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

SelectFormContainer

FUNCTION IMAPIFormMgr_SelectFormContainer ( _
  BYVAL pIMAPIFormMgr AS DWORD PTR _
, BYVAL ulUIParam AS DWORD _
, BYVAL ulFlags AS DWORD _
, BYREF lppfcnt AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMAPIFormMgr[10] USING IMAPIFormMgr_SelectFormContainer (pIMAPIFormMgr, ulUIParam, ulFlags, lppfcnt) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

OpenFormContainer

FUNCTION IMAPIFormMgr_OpenFormContainer ( _
  BYVAL pIMAPIFormMgr AS DWORD PTR _
, BYVAL hfrmreg AS DWORD _
, BYVAL lpunk AS DWORD _
, BYREF lppfcnt AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMAPIFormMgr[11] USING IMAPIFormMgr_OpenFormContainer (pIMAPIFormMgr, hfrmreg, lpunk, lppfcnt) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

PrepareForm

FUNCTION IMAPIFormMgr_PrepareForm ( _
  BYVAL pIMAPIFormMgr AS DWORD PTR _
, BYVAL ulUIParam AS DWORD _
, BYVAL ulFlags AS DWORD _
, BYVAL pfrmiInfo AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMAPIFormMgr[12] USING IMAPIFormMgr_PrepareForm (pIMAPIFormMgr, ulUIParam, ulFlags, pfrmiInfo) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

IsInConflict

FUNCTION IMAPIFormMgr_IsInConflict ( _
  BYVAL pIMAPIFormMgr AS DWORD PTR _
, BYVAL ulMessageFlags AS DWORD _
, BYVAL ulMessageStatus AS DWORD _
, BYREF szMessageClass AS ASCIIZ _
, BYVAL pFolderFocus AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIMAPIFormMgr[13] USING IMAPIFormMgr_IsInConflict (pIMAPIFormMgr, ulMessageFlags, ulMessageStatus, szMessageClass, pFolderFocus) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION