Retrieve a shared variable value.
JagStatus JagGetSharedData ( JagSharedData * pData, SQLPOINTER buf, SQLINTEGER buflen, SQLINTEGER * outlen)
The shared variable handle.
The buffer to which the shared variable value is to be copied.
The length, in bytes, of the buffer addressed by buf.
The address of a SQLINTEGER variable. On output, contains the length of the copied value. If no value has been set for the property, the length will be zero.
Return value |
To indicate |
|---|---|
JAG_SUCCEED |
Success, even if there was no value to copy |
JAG_FAIL |
Failure |
JagGetSharedValue fails if the size of the value is too large for the buffer.
Check the server’s log file for more information when JagGetSharedValue fails.
You must create the buffer before you retrieve the shared variable value. Make sure the buffer is large enough to hold any value that can be stored in the shared variable.
See Appendix C, “Creating C Components,” in the EAServer Programmer’s Guide for more information.
JagGetSharedData, JagGetSharedDataByIndex, JagLockCollection, JagLockNoWaitCollection, JagNewSharedData, JagNewSharedDataByIndex, JagSetSharedValue, JagUnlockCollection
