NXKeySetValue

Associates the specified value with the specified key for the calling context.

Library:LibC
Classification:NKS
Service:Threads

Syntax

  #include <nks/thread.h> 
   
  int NXKeySetValue (
     NXKey_t   key, 
     void     *value);
  

Parameters

key

(IN) Specifies the key for which the value is to be set.

value

(IN) Points to the value to be associated with the specified key. NULL is the default initial value that is associated with each context for an allocated key.

Return Values

If successful, returns 0; otherwise, returns a nonzero error code:

Decimal

Hex

Constant

Description

14

0x0E

NX_ERANGE

The specified key is invalid (out of range)

Remarks

The value set by calling NXKeySetValue can be returned later by calling NXKeyGetValue.

For sample code, see KeyValue.c.

See Also