imapiformfactory-lockserver.md

title	manager	ms.date	ms.audience	ms.topic	ms.service	ms.localizationpriority	api_name	api_type	ms.assetid
IMAPIFormFactoryLockServer	lindalu	11/16/2014	Developer	reference	office-online-server	medium	IMAPIFormFactory.LockServer	COM	b9bd389a-6975-41a2-a2f4-e501312e434b

IMAPIFormFactory::LockServer

Applies to: Outlook 2013 | Outlook 2016

Keeps an open form server in memory.

HRESULT LockServer(
  ULONG ulFlags,
  ULONG fLockServer
);

Parameters

ulFlags

[in] Reserved; must be zero.

fLockServer

[in] true to increment the lock count; otherwise, false.

Return value

S_OK

The call succeeded and has returned the expected value or values.

Remarks

Form viewers call the IMAPIFormFactory::LockServer method to keep an open form server application in memory. Keeping the form server in memory improves its performance when forms are frequently created and released.

Notes to implementers

The IMAPIFormFactory::LockServer method is very similar to the IClassFactory::LockServer method. Essentially, the IMAPIFormFactory::LockServer method maintains a count of how many times it has been called; as long as that count is greater than 0, the method prevents the form server from being unloaded from memory. You can use the CoLockObjectExternal function to implement this.

See also

IMAPIFormFactory : IUnknown