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.

See "Share Data Between C Components" in the Jaguar CTS Programmer's Guide for more information.

See Also

JagLockCollection, JagLockNoWaitCollection

 


Copyright © 2000 Sybase, Inc. All rights reserved.