L_ContainerGetCallback

Summary

Gets the current user-installed callback function that is used to inform the user about container events.

Syntax

L_LTCON_API L_INT L_ContainerGetCallback(pContainer, ppCallback, ppUserData)

Parameters

pCONTAINERHANDLE pContainer

Pointer to a container handle.

pCONTAINERCALLBACK * ppCallback

Pointer to the variable to be updated with the current user callback function address.

L_VOID ** ppUserData

Pointer to the variable to be updated with a pointer to the current user data.

Returns

Comments

If there is no user callback function currently installed, the function returns NULL for the ppCallback and ppUserData.

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_ContainerSetCallback

Topics

• Using the Container Callback

Example

This function will determine if the container is installed or not.

L_BOOL ContainerGetCallbackExample(pCONTAINERHANDLE      pContainer, 
                                   pCONTAINERCALLBACK*   ppConCallback, 
                                   L_INT * nRet, 
                                   L_VOID **ppUserData) 
{ 
   *nRet = L_ContainerIsValid ( pContainer ); 
 
   if ( *nRet == SUCCESS  ) /* check the validity of container handle */ 
   { 
      /* get the container callback functoin pointer */ 
      *nRet = L_ContainerGetCallback ( pContainer, ppConCallback, ppUserData ) ; 
      if(*nRet != SUCCESS) 
         return FALSE; 
 
      if ( NULL != *ppConCallback )  
      { 
         return TRUE ; 
      } 
      else 
      { 
         return FALSE ; 
      } 
   } 
   else 
   { 
      return FALSE ; 
   } 
}