Maintaining a Form Library

A form library holds all of the important information about a form: its properties, its verbs, and its server's executable files. Some clients allow their users to maintain, install, or remove form servers. If you want to offer this feature to your users, you must have access to:

• The form server's configuration file, a file with the .CFG extension.
• The form library's container object, an object that implements the IMAPIFormContainer : IUnknown interface.

To access the configuration file or a pathname to it, use whatever means are convenient. Usually, clients present the user with a dialog box for installing and removing form servers that can also be used to prompt the user for the location of the configuration file.

To access the form library's container, call the form manager's IMAPIFormMgr::OpenFormContainer method. Pass in an enumeration value to specify which form library to open, and if necessary, a pointer to the object that the form manager should use to open the form library. For example, if you are opening a folder form library, pass an IMAPIFolder pointer.

After OpenFormContainer returns the IMAPIFormContainer pointer, call either IMAPIFormContainer::InstallForm or IMAPIFormContainer::RemoveForm, depending on the maintenance to be performed. InstallForm adds a form server to the library; RemoveForm deletes a form server from the library.