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_query_row

vtc_query_row

Deprecated. Use lrvtc_query_row. Retrieves the data in a row.

C Language

VTCERR2 vtc_query_row ( PVCI2 pvci, int rowIndex, char ***outColumns, char ***outValues );

C# Language

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

Java Language

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

Arguments

Name Comments
pvci The server connection handle.
rowIndex The number of the row. The first row has index 1.
outColumns Array of column names. The last entry in the array must be NULL.
outValues Array of the values of the columns.

vtc_query_row retrieves the data in the specified row. The names of the columns and their values are output in the outcolumns and outvalues arrays.

If there is no data in a cell, the corresponding output is NULL.

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

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

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

int rc = 0;
char **colnames = NULL;
char **rowdata = NULL;

rc = vtc_query_row(pvci, 1, &colnames, &rowdata)
lr_output_message("Query Row Names : %s , %s", 
                   colnames[0], colnames[1]);
lr_output_message("Query Row Data  : %s , %s", 
                  rowdata[0], rowdata[1]);
vtc_free_list(colnames);
vtc_free_list(rowdata);

C# Language Example

.Net Multiple Connection Example

Java Language Example

Java Multi-Connection Example