BCX COM Interface

BCX_COM_ERROR function

Purpose: BCX_COM_ERROR returns status of the the COM error indicator.

To get more information of error, call BCX_GET_COM_ERROR_DESC or BCX_GET_COM_ERROR_CODE.


 Syntax:

 RetBool = BCX_COM_ERROR 

 Parameters:

  • RetBool boolean TRUE or FALSE status of the COM error indicator. If a COM error occurs, TRUE is returned. If there is no error FALSE is returned.

BCX_GET_COM_SUCCESS function

Purpose: BCX_GET_COM_SUCCESS is opposite of BCX_COM_ERROR function. If a COM error does not occur, TRUE is returned. If there is an error, FALSE is returned.

To get more information of error, call BCX_GET_COM_ERROR_DESC or BCX_GET_COM_ERROR_CODE.


 Syntax:

 RetBool = BCX_GET_COM_SUCCESS 

 Parameters:

  • RetBool boolean TRUE or FALSE status of the COM error indicator. If a COM error does not occur, TRUE is returned. If there is an error, FALSE is returned.

Example:


 CLS
 
 DIM app AS OBJECT
 app = CREATEOBJECT("Excel.Application")
 
 IF BCX_COM_ERROR THEN
 PRINT BCX_GET_COM_ERROR_DESC$
 END
 END IF
  
 app.visible = true
 
 Sleep(2000) ' Excel will be visible for 2 sec, and than it will close.
 
 app.activeworkbook.saved = true ' don't prompt to save workbook
 
 app.quit
 
 SET app = NOTHING ' remember to call Set xxx = Nothing to release resources used by COM object!!!
 
 
 KEYPRESS

For more examples of the BCX COM functions see the COM folder in the Files section of the BCX Group on Yahoo.

Related topics: Object data type definition | CREATEOBJECT | List of all COM Interface Functions