NXKeyGetValue

Returns the value associated with the specified key.

Library:LibC

Classification:NKS

Service:Threads

Syntax

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

key: (IN) Specifies the key for which the value is to be returned.
value: (OUT) Points to a location in which to return the value of the specified key. The default initial value associated with each context for an allocated key is NULL.

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

NXKeyGetValue returns the value associated with the specified key for the invoking context.

For sample code, see KeyValue.c.