cma_key_set_context

Sets the per-thread context associated with the specified key for the current thread.

Syntax

cma_key_set_context( key, context_value);

Argument Data Type Access

key opaque cma_t_key read context_value opaque cma_t_address read

C Binding

#include 


void
cma_key_set_context (
         cma_t_key   key,
         cma_t_address   context_value);

Arguments

key: Context key value that uniquely identifies the context value specified in context_value. This key value must have been obtained from cma_key_create.
context_value: Address containing data associated with the specified key for the current thread; this is the per-thread context.

Description

This routine sets the per-thread context associated with the specified key for the current thread. If a context has been defined for the key in this thread (the current value is not null), the new value is substituted for it.

The exception cma_e_badparam is raised if the context key is invalid.

Exceptions

cma_e_badparam