Chapter 5 C Routines Reference

JagGetSharedData

Use the shared variable name to retrieve a shared variable handle.

JagStatus JagGetSharedData (
            JagDataCollection * pCollection,
            SQLPOINTER name,
            JagSharedData ** ppProp)

pCollection

The handle of the collection to which the shared variable belongs.

name

The name of the shared variable.

ppProp

The shared variable handle. JagGetSharedData sets *ppProp to NULL if the shared variable does not exist.

Return value	To indicate
JAG_SUCCEED	Success, even if the property does not exist
JAG_FAIL	Failure

Check the server's log file for more information when JagGetSharedData fails.

This routine can retrieve only the handle of a property that has been created using the JagNewSharedData routine.

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