In This Topic ▼

L_ContainerFree

Summary

Frees the container handle.

Syntax

#include "LtCon.h"

L_LTCON_API L_INT L_ContainerFree(pContainer)

Parameters

pCONTAINERHANDLE pContainer

Pointer to a container handle.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Freeing the container handle will detach it from its owner window.

Required DLLs and Libraries

LTCON
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

Example

This example checks the validity of the container handle and then frees it.

L_INT ContainerFreeExample(pCONTAINERHANDLE pContainer) 
{ 
   L_INT nRet = L_ContainerIsValid ( pContainer ); 
   if (SUCCESS == nRet ) /* check the validity of container handle */ 
   { 
       /* Free the container handle */ 
      nRet = L_ContainerFree ( pContainer ) ; 
   } 
   return nRet; 
}