TutCondDestroy

TutCondDestroy — destroy a condition variable

T_BOOL TutCondDestroy(cond) 
T_COND cond;

cond — condition variable to destroy

TRUE if condition variable was successfully destroyed, FALSE otherwise.

If TutCondDestroy fails, it returns FALSE and sets the global SmartSockets error number to one of:

T_ERR_OS — an operating system error has occurred. The function TutErrNumGetOs should be called to obtain the related OS-specific error value.

T_ERR_TYPE_MISMATCH — the platform does not support threads

T_ERR_VAL_INVALID — cond is not a valid condition variable

TutCondDestroy destroys a condition variable. All operating system resources associated with the condition variable are released.

Destroying a condition variable that other threads (in the same process) are waiting on has undefined results.

This example creates and then destroys a condition variable:

T_COND cond; 
cond = TutCondCreate(); 
if (T_INVALID_COND == cond) { 
  /* error */ 
} 
... 
if (!TutCondDestroy(cond)) { 
  /* error */ 
}