cma_key_get_context

Obtains the per-thread context associated with the specified key.

Syntax

cma_key_get_context( key, context_value);

Argument Data Type Access

key opaque cma_t_key read context_value opaque cma_t_address write

C Binding

#include 


void
cma_key_get_context (
         cma_t_key   key,
         cma_t_address   *context_value);

Arguments

key: Context key value that uniquely identifies the context value obtained. This key value must have been obtained from cma_key_ create.
context_value: Variable that receives the address of the current per-thread context value associated with the specified key.

Description

This routine obtains the per-thread context associated with the specified key for the current thread. If a context has not been defined for the key in this thread, the null pointer cma_c_null_ptr is returned in context_value.

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

Exceptions

cma_e_badparam