VMS Help
POSIX Threads, TIS routines, tis_setspecific
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
|
Changes the value associated with the specified thread-specific
data key.
#include <tis.h>
int
tis_setspecific (
pthread_key_t key,
const void *value);
key
Thread-specific data key that identifies the data to receive
value. Must be obtained from a call to tis_key_create().
value
New value to associate with the specified key. Once set, this
value can be retrieved using the same key in a call to tis_
getspecific().
This routine sets the value associated with the specified thread-
specific data key. If a value is defined for the key (that is,
the current value is not NULL), the new value is substituted for
it. The key is obtained by a previous call to tis_key_create().
Do not call this routine from a data destructor function. Doing
so could lead to a memory leak or an infinite loop.
If an error condition occurs, this routine returns an integer
indicating the type of error. Possible return values are as
follows:
Return Description
0 Successful completion.
[EINVAL] The value specified by key is not a valid key.
[ENOMEM] Insufficient memory to associate the value with the
key.
tis_getspecific()
tis_key_create()
tis_key_delete()
[legal]
[privacy]
[GNU]
[policy]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.