Share this page

# 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

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.

## Parameterization

All string input arguments can be passed using standard parameterization.

## C Language Example

Copy code

    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

Tips to improve your search results... VuGen Function Reference Version 26.1-26.3 Function Reference 26.1-26.3 All View Local Help Center View Online Help Center Version: