JagUnlockCollection

Description

Unlock a collection.

Syntax

JagStatus JagUnlockCollection (
            JagDataCollection * pCollection)

Parameters

pCollection

The handle of the collection to unlock.

Returns

Return value

To indicate

JAG_SUCCEED

Success, even if the calling method has not locked the collection

JAG_FAIL

Failure

Check the server’s log file for more information when JagUnlockCollection fails.

Usage

The JagUnlockCollection method releases a lock on a collection. A locked collection is automatically released when the object’s method execution is completed. However, to make your application more efficient and prevent deadlocks, unlock a collection when you are finished updating or reading the shared variable in the collection so that other objects can access the collection right away.

See Appendix C, “Creating C Components,” in the EAServer Programmer’s Guide for more information.

See also

JagLockCollection, JagLockNoWaitCollection