Chapter 5 C Routines Reference

JagGetSharedDataByIndex

Use the shared variable index number to retrieve a shared variable handle.

JagStatus JagGetSharedData (
            JagDataCollection * pCollection,
            SQLINTEGER index,
             JagSharedData ** ppData)

pCollection

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

index

The index of the shared variable.

ppProp

The shared variable handle. *ppProp is set 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 JagGetSharedDataByIndex fails.

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

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