[Previous] [Contents] [Next]

ds_set()

Set a data server variable

Synopsis:

#include <ds.h>

int ds_set( ds_t dsdes,
            const char* variable_name,
            const char* variable_data,
            size_t data_len );

Library:

libds

Description:

The ds_set() function passes the data variable_data to the data server identified by dsdes. The data server stores the data in the variable whose name is given by variable_name, overwriting any existing value.

To display the modified data on an HTML page, use the qnxvar token with the read tag. See the description of slinger in the Utilities reference.

Returns:

0 for success, or -1 if an error occurs (errno is set).

Errors:

EBADF
Invalid file descriptor dsdes.
ENOMEM
Not enough memory to store the data.
ESRCH
The variable doesn't exist in the data server.

Examples:

See slinger in the Utilities reference.

Classification:

QNX 6

Safety:
Cancellation point Yes
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

ds_create(), ds_flags(), ds_get()


[Previous] [Contents] [Next]