GetRdci
Returns the RDCI structure from the API buffers. This function is necessary when you call WriteRdciRdcm with preserve lock. After calling WriteRdciRdcm, call GetRdci to synchronize the information on the RDCI with the information in the buffer that was updated by WriteRdciRdcm. You may then begin data entry by calling InitializeRdcmResponses.
Syntax
short int GetRdci(RdciRecord*rdci_rec);
Parameters
rdci_rec (out) contains the contents of the API RDCI record in a data structure of type RdciRecord.
Return Value
SUCCESS or FAILURE.
Comments
This function fails if the API RDCI buffer is empty. In order to:
- populate an empty API RDCI buffer, see CreateRdci and FetchRdci.
- change the contents of the API RDCI record, see SetRdci.
- process the API RDCI record as a unit, see ProcessRdci.
Error Messages
Table 7-19 Error Messages for GetRdci
| Number | Severity | Message |
|---|---|---|
|
284900 |
ERR |
User does not have the privilege to call function in the current mode. |
|
285000 |
ERR |
Function called out of sequence. |
|
285900 |
ERR |
No current OCL database connection open. Use ConnectOCL to connect to OCL database. |
|
286600 |
ERR |
Audit reason required and not provided. |
|
297000 |
ERR |
Null or invalid input pointers provided. |
|
304600 |
ERR |
Function does not exist. |
|
304700 |
ERR |
Privilege does not exist. |
Related Functions
Parent topic: Data Capture API Functions