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.

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 Appendix C, “Creating C Components,” in the EAServer Programmer’s Guide for more information.