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 ( long pvci, out string[] outColumns, out string[] outValues );
Query Functions

Arguments

NameComments
pvciThe server connection handle.
outColumns

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

outValuesArray 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.

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