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_free

vtc_free

Releases a string buffer.

C Language

void vtc_free ( char *message );
Global Functions

Arguments

Name Comments
message The variable previously passed to a function that allocated memory for a string return value.

vtc_free deallocates a buffer allocated by functions that return strings. These functions have arguments of type char **. For example, char **outvalue.

Pass vtc_free the variable name of the output argument. For example, after calling

    vtc_retrieve_message ( mypvci, "ColumnName", &myOutValue );

call

    vtc_free( myOutValue );.

To free a string array buffer, use vtc_free_list.

Return Values

No value returned.

Parameterization

All string input arguments can be passed using standard parameterization.

C Language Example

vtc_free( myStringVariable );