This topic has not yet been rated - Rate this topic

IMAPIFormFactory::LockServer

Published: July 16, 2012

Keeps an open form server in memory.

HRESULT LockServer(
  ULONG ulFlags,
  ULONG fLockServer
);
ulFlags

[in] Reserved; must be zero.

fLockServer

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

S_OK

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

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.

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.

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.