CmtReleaseTSVPtr

int CmtReleaseTSVPtr (int variableHandle);

Purpose

Releases the pointer to the thread safe variable.

You must call this function from the same thread that called CmtGetTSVPtr. You must call this function once for each time that you called CmtGetTSVPtr.

It is difficult to program with this function directly. It is easier to program with the functions provided by the DefineThreadSafeScalarVar, DeclareThreadSafeScalarVar, DefineThreadSafeScalarVar, and DeclareThreadSafeScalarVar macros, which are defined in utility.h.

Parameters

Input
Name Type Description
variableHandle integer The handle you obtained from CmtNewTSV to identify the thread safe variable.

Return Value

Name Type Description
CmtStatus integer The CmtStatus code that the function call returns. This function returns 0 to indicate success and negative values to indicate failure. Pass the CmtStatus code to CmtGetErrorMessage to get a description of the error code.