Use the shared variable name to retrieve a shared variable handle.
JagStatus JagGetSharedData ( JagDataCollection * pCollection, SQLPOINTER name, JagSharedData ** ppProp)
The handle of the collection to which the shared variable belongs.
The name of the shared variable.
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.
JagFreeSharedDataHandle, JagGetSharedDataByIndex, JagNewSharedData, JagNewSharedDataByIndex
