Reference: IVEThreadInitKey

Overview

IVEThreadInitKey creates a handle which all threads in the calling process may use to get (IVEThreadGetKeyValue) and set (IVEThreadSetKeyValue) thread-specific data.

Prototype (C)

#include "ive_standards.h"
#include "ive_thread.h"
void IVEThreadInitKey(IVEThreadKey* p_key, int* p_status);

Prototype (Fortran)

There is no Fortran interface.

Parameters

p_key

p_key points to the key to be initialized.

p_status

If the call fails, *p_status will be set to one of the values below; otherwise its value is not modified.

IVE_ERR_NO_MEM

There was insufficient memory available to complete the operation.

IVE_ERR_NO_RESOURCES

There was insufficient system resources available (other than memory) to complete the operation.

IVE_ERR_UNRECOGNIZED

The operating system or system library returned an error code that was not expected.

Side effects

Inclusion of ive_standards.h sets certain feature-set macros. It is safest to include it before any other headers to avoid inconsistent definitions.

Cross references

IVEThreadDestroyKey, IVEThreadSetKeyValue, IVEThreadGetKeyValue, and IVEThreadKey

| categories | alphabetical |

modified May 7, 2002