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 );

Arguments:

dsdes

A data server descriptor returned by ds_register().

variable_name

The name of the data server variable that you want to set.

variable_data

A pointer to the data you want to associate with the variable.

data_len

The size of the data, in bytes.

Library:

libds

Use the -l ds option to qcc to link against this library.

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 Neutrino

See also:

ds_create(), ds_flags(), ds_get()