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_update_message

vtc_update_message

Deprecated. Use lrvtc_update_message. Replaces the data in a field.

C Language

VTCERR2 vtc_update_message ( PVCI2 pvci,  char *columnName, int rowIndex , char *value, unsigned short *outRc );

C# Language

bool vts_multi.update_message ( int pvci,  string columnName, int rowIndex , string value);

Java Language

int Vtc.update_message (  long pvci,  string columnName, int rowIndex , string value, OutIntParameter outRc);
Data Update Functions

Arguments

Name Comments
pvci The server connection handle.
columnName The column to write to.
rowIndex The number of the row. The first row has index 1.
value The value to set the field to.
outRc The status of the operation: 1 - Pass or 0 - Fail

vtc_update_message writes the value to the field specified with the column name and row index. The value in the field before vtc_update_message is called is overwritten.

Return Values

Returns zero on success or one of the Error Codes.

C# Language: Returns true on success.

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

Parameterization

All string input arguments can be passed using standard parameterization.

Example

int rc, row_number;
unsigned short status;
....
// Write to the last row
vtc_column_size(pvci, "C_ID" &row_number);
rc = vtc_update_message(pvci, "C_info",
    row_number,
    "{p_cid}_info_updated",
    &status);
lr_log_message("update_message status=%d\n", status);

	

C# Language Example

.Net Multiple Connection Example

Java Language Example

Java Multi-Connection Example