L_ContainerFree

#include "LtCon.h"

L_LTCON_API L_INT L_ContainerFree(pContainer)

pCONTAINERHANDLE pContainer;

/* pointer to a container handle */

Frees the container handle.

Parameter

Description

pContainer

Pointer to a container handle.

Returns

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

See Also

Functions:

L_ContainerIsValid, L_ContainerInit.

Topics:

Initializing and Freeing a Container

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;
}