Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/d/ds_set.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/d/ds_set.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/d/ds_set.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/d/ds_set.html on line 8

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

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

See also:

ds_create(), ds_flags(), ds_get()


Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/d/ds_set.html on line 160

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/d/ds_set.html on line 160