Chapter 5 C Routines Reference

JagUnlockCollection

Description

Unlock a collection.

Syntax

JagStatus JagUnlockCollection (
            JagDataCollection * pCollection)

Parameters

pCollection

The handle of the collection to unlock.

Return Values

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.