ds_get()

Retrieve a data server variable

Synopsis:

#include <ds.h>

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

Library:

ds3r.lib, ds3s.lib

Description:

The ds_get() function retrieves the data corresponding to variable_name from the data server dsdes, and places it in the buffer pointed to by variable_data. The data_len argument is the size of variable_data.

Returns:

The amount of data written to the buffer variable_data, or -1 if an error occurs (errno is set).

Errors:

EBADF

Invalid file descriptor dsdes.

EMSGSIZE

The buffer isn't big enough for the data.

ESRCH

The variable doesn't exist in the data server.

Classification:

QNX 4

See also:

ds_create(), ds_set()