Utility Functions and C Language Reference > Virtual Table Server Functions (VTS) for C, C#, and Java > Virtual Table Server (VTS) Functions for Multiple Connections > Alphabetical Listing > vtc_retrieve_row

vtc_retrieve_row

Deprecated. Use lrvtc_retrieve_row. Pops the first fields from all columns.

C Language

VTCERR2 vtc_retrieve_row ( PVCI2 pvci, char ***outColumns, char ***outValues );

C# Language

void vts_multi.retrieve_row ( int pvci, out string[] outColumns, out string[] outValues );

Java Language

int Vtc.retrieve_row (  long pvci, OutArrOfStrParameter outColumns, OutArrOfStrParameter outValues );
Query Functions

Arguments

Name Comments
pvci The server connection handle.
outColumns

Array of column names. The last entry in the array must be NULL.

outValues Array of the values of the columns.

vtc_retrieve_row retrieves the values from the fields in the top row. The names of the columns and their values are output in the outColumns and outValues arrays.

In C, outColumns and outValues are pointers to an array of strings.

All fields below the first row move up one row. For example, after the call, the values that were in the second row are in the first row, the values that were in the third row are in the second row, and so on. The last field of each column is cleared.

After using the output values, free the output buffers with vtc_free_list.

Return Values

C Language:   Returns zero on success or one of the Error Codes.

C# Language: No return value.

Java Language:   Returns zero on success or one of the Error Codes.

Parameterization

All string input arguments can be passed using standard parameterization.

C Language Example

char **outvalues = NULL;
char **outcolumns = NULL;
int rc;
...

rc = vtc_retrieve_row(pvci, &outcolumns, &outvalues);
lr_log_message("retrieve_row rc=%d\n", rc);
    

C# Language Example

.Net Multiple Connection Example

Java Language Example

Java Multi-Connection Example