Jump to content

COM error handling in a UDF - best practice?


orbs
 Share

Recommended Posts

COM error handling is a global thing, right? when i declare this:

$oCOMError = ObjEvent('AutoIt.Error', '_COMErrorHandler')

it means that whatever previous declaration i made for "AutoIt.Error" is discarded.

now, suppose i write a UDF that uses COM, and i want to introduce COM error handling in the UDF. i do just that, but then, the main script declares a COM error handler for its own purposes, that is unaware of the UDF COM error handler. this means the UDF COM error handler is discarded.

how to approach such a situation, when i want the UDF COM error handler to not interfere with the main script COM error handler, but still operate?

thanks for any ideas.

Signature - my forum contributions:

Spoiler

UDF:

LFN - support for long file names (over 260 characters)

InputImpose - impose valid characters in an input control

TimeConvert - convert UTC to/from local time and/or reformat the string representation

AMF - accept multiple files from Windows Explorer context menu

DateDuration -  literal description of the difference between given dates

Apps:

Touch - set the "modified" timestamp of a file to current time

Show For Files - tray menu to show/hide files extensions, hidden & system files, and selection checkboxes

SPDiff - Single-Pane Text Diff

 

Link to comment
Share on other sites

Look in my ADO and XML udf.

HINT: You should declare COM ERROR HANDLER in UDF locally for each function.

 

Edited by mLipok

Signature beginning:
Please remember: "AutoIt"..... *  Wondering who uses AutoIt and what it can be used for ? * Forum Rules *
ADO.au3 UDF * POP3.au3 UDF * XML.au3 UDF * IE on Windows 11 * How to ask ChatGPT for AutoIt Codefor other useful stuff click the following button:

Spoiler

Any of my own code posted anywhere on the forum is available for use by others without any restriction of any kind. 

My contribution (my own projects): * Debenu Quick PDF Library - UDF * Debenu PDF Viewer SDK - UDF * Acrobat Reader - ActiveX Viewer * UDF for PDFCreator v1.x.x * XZip - UDF * AppCompatFlags UDF * CrowdinAPI UDF * _WinMergeCompare2Files() * _JavaExceptionAdd() * _IsBeta() * Writing DPI Awareness App - workaround * _AutoIt_RequiredVersion() * Chilkatsoft.au3 UDF * TeamViewer.au3 UDF * JavaManagement UDF * VIES over SOAP * WinSCP UDF * GHAPI UDF - modest begining - comunication with GitHub REST APIErrorLog.au3 UDF - A logging Library * Include Dependency Tree (Tool for analyzing script relations) * Show_Macro_Values.au3 *

 

My contribution to others projects or UDF based on  others projects: * _sql.au3 UDF  * POP3.au3 UDF *  RTF Printer - UDF * XML.au3 UDF * ADO.au3 UDF SMTP Mailer UDF * Dual Monitor resolution detection * * 2GUI on Dual Monitor System * _SciLexer.au3 UDF * SciTE - Lexer for console pane

Useful links: * Forum Rules * Forum etiquette *  Forum Information and FAQs * How to post code on the forum * AutoIt Online Documentation * AutoIt Online Beta Documentation * SciTE4AutoIt3 getting started * Convert text blocks to AutoIt code * Games made in Autoit * Programming related sites * Polish AutoIt Tutorial * DllCall Code Generator * 

Wiki: Expand your knowledge - AutoIt Wiki * Collection of User Defined Functions * How to use HelpFile * Good coding practices in AutoIt * 

OpenOffice/LibreOffice/XLS Related: WriterDemo.au3 * XLS/MDB from scratch with ADOX

IE Related:  * How to use IE.au3  UDF with  AutoIt v3.3.14.x * Why isn't Autoit able to click a Javascript Dialog? * Clicking javascript button with no ID * IE document >> save as MHT file * IETab Switcher (by LarsJ ) * HTML Entities * _IEquerySelectorAll() (by uncommon) * IE in TaskSchedulerIE Embedded Control Versioning (use IE9+ and HTML5 in a GUI) * PDF Related:How to get reference to PDF object embeded in IE * IE on Windows 11

I encourage you to read: * Global Vars * Best Coding Practices * Please explain code used in Help file for several File functions * OOP-like approach in AutoIt * UDF-Spec Questions *  EXAMPLE: How To Catch ConsoleWrite() output to a file or to CMD *

I also encourage you to check awesome @trancexx code:  * Create COM objects from modules without any demand on user to register anything. * Another COM object registering stuffOnHungApp handlerAvoid "AutoIt Error" message box in unknown errors  * HTML editor

winhttp.au3 related : * https://www.autoitscript.com/forum/topic/206771-winhttpau3-download-problem-youre-speaking-plain-http-to-an-ssl-enabled-server-port/

"Homo sum; humani nil a me alienum puto" - Publius Terentius Afer
"Program are meant to be read by humans and only incidentally for computers and execute" - Donald Knuth, "The Art of Computer Programming"
:naughty:  :ranting:, be  :) and       \\//_.

Anticipating Errors :  "Any program that accepts data from a user must include code to validate that data before sending it to the data store. You cannot rely on the data store, ...., or even your programming language to notify you of problems. You must check every byte entered by your users, making sure that data is the correct type for its field and that required fields are not empty."

Signature last update: 2023-04-24

Link to comment
Share on other sites

let me see if i get this right:

the main script can define a dedicated function, which resides in the main script, that will handle COM error in the ADO UDF. the ADO UDF error handler, which is not declared globally but at the beginning of every UDF function (thus revoked once the function had returned), will call the main script dedicated function if declared, otherwise will call the UDF default COM error handler.

if so, how should the main script declare a COM error handler for COM operations not related to the UDF?

Signature - my forum contributions:

Spoiler

UDF:

LFN - support for long file names (over 260 characters)

InputImpose - impose valid characters in an input control

TimeConvert - convert UTC to/from local time and/or reformat the string representation

AMF - accept multiple files from Windows Explorer context menu

DateDuration -  literal description of the difference between given dates

Apps:

Touch - set the "modified" timestamp of a file to current time

Show For Files - tray menu to show/hide files extensions, hidden & system files, and selection checkboxes

SPDiff - Single-Pane Text Diff

 

Link to comment
Share on other sites

oh, i see what i was missing. the error handler functions accept a parameter! and that parameter is assigned with the error object that was declared in the corresponding ObjEvent() command. not so obvious, but now it makes sense. thanks (again...) @water

Signature - my forum contributions:

Spoiler

UDF:

LFN - support for long file names (over 260 characters)

InputImpose - impose valid characters in an input control

TimeConvert - convert UTC to/from local time and/or reformat the string representation

AMF - accept multiple files from Windows Explorer context menu

DateDuration -  literal description of the difference between given dates

Apps:

Touch - set the "modified" timestamp of a file to current time

Show For Files - tray menu to show/hide files extensions, hidden & system files, and selection checkboxes

SPDiff - Single-Pane Text Diff

 

Link to comment
Share on other sites

;)

My UDFs and Tutorials:

Spoiler

UDFs:
Active Directory (NEW 2022-02-19 - Version 1.6.1.0) - Download - General Help & Support - Example Scripts - Wiki
ExcelChart (2017-07-21 - Version 0.4.0.1) - Download - General Help & Support - Example Scripts
OutlookEX (2021-11-16 - Version 1.7.0.0) - Download - General Help & Support - Example Scripts - Wiki
OutlookEX_GUI (2021-04-13 - Version 1.4.0.0) - Download
Outlook Tools (2019-07-22 - Version 0.6.0.0) - Download - General Help & Support - Wiki
PowerPoint (2021-08-31 - Version 1.5.0.0) - Download - General Help & Support - Example Scripts - Wiki
Task Scheduler (NEW 2022-07-28 - Version 1.6.0.1) - Download - General Help & Support - Wiki

Standard UDFs:
Excel - Example Scripts - Wiki
Word - Wiki

Tutorials:
ADO - Wiki
WebDriver - Wiki

 

Link to comment
Share on other sites

  • 10 months later...
On 12/5/2017 at 10:42 PM, water said:

Func FunctionLocal()     Local $oLocalCOMErrorHandler = ObjEvent("AutoIt.Error", "_ErrFuncLocal") ; Local COM error handler     $oIE.xyz EndFunc

I would like to know on where "AutoIt.Error" come from, would it be used for all purpose as a standard parameter?

Do you have any suggestions?
Thanks, to everyone very much for any suggestions (^v^)

 

Link to comment
Share on other sites

  • 1 month later...
On 29.10.2018 at 3:37 PM, oemript said:

I would like to know on where "AutoIt.Error" come from, would it be used for all purpose as a standard parameter?

Do you have any suggestions?
Thanks, to everyone very much for any suggestions (^v^)

 

as you can see in HelpFile:
 

Quote

ObjEvent

Handles incoming events from the given Object.

ObjEvent ( $ObjectVar, "functionprefix" [, "interface name"] )
ObjEvent ( "AutoIt.Error" [, "function"] )

in syntax section you see two "formats" which in Remarks are descibed as:

Quote

The first format is used to receive Events from the given Object.
To receive a specific event, create an AutoIt function name using the given prefix appended with the event name.

The second format is used for COM Error Handling.

The second format is an internal "AutoIt" way to change how ObjEvent() acts.

 

The following part of this post, is my way how I understand this feature.

BEWARE: This is only my humble opinion :)

 

The first format              is used to handle specyfic EVENT of specyfic COM/ActiveX object


The second format        is used to handle COM/ActiveX Errors and then "function" given in second parameter became "COM ERROR HANDLER" for all Error's fired by any COM/ActiveX ERROR, but only   fired by any COM/ActiveX which is used in the same level/scope as  "COM ERROR HANDLER"  was declared by using  in ObjEvent () specyfic keyword Global / Local . For this reason Return from ObjEvent() must be stored to variable, also because cleaning/reseting this this variable is a way to disable "COM ERROR HANDLER". The reasone to store this variable is also to have possibility to set it in Local scope and hide any COM errors in the inner function area (out of UDF). This is also a way to change COM Errors into specyfic @error defined by UDF Developer , as an example you could look in ie.au3 exactly here:
 

Func __IEComErrorUnrecoverable($iError)
    Switch $iError
        ; Cross-domain scripting security error
        Case -2147352567 ; "an exception has occurred."
            Return $_IESTATUS_AccessIsDenied
        Case -2147024891 ; "Access is denied."
            Return $_IESTATUS_AccessIsDenied
            ;
            ; Browser object is destroyed before we try to operate upon it
        Case -2147417848 ; "The object invoked has disconnected from its clients."
            Return $_IESTATUS_ClientDisconnected
        Case -2147023174 ; "RPC server not accessible."
            Return $_IESTATUS_ClientDisconnected
        Case -2147023179 ; "The interface is unknown."
            Return $_IESTATUS_ClientDisconnected
            ;
        Case Else
            Return $_IESTATUS_Success
    EndSwitch
EndFunc   ;==>__IEComErrorUnrecoverable

 

or soon (not published yet) you will be able to show how to Get Last Error Description in my new version of Debenu Quick PDF Library - UDF:

Func _QPDF_LastError_Set(ByRef $oQP, $iError = @error, $iExtended = @extended)
    _QPDF_LastError_SetCode($oQP)
    _QPDF_LastError_SetDescription($oQP)
    Return SetError($iError, $iExtended, $QPDF_RET_DEFAULT)
EndFunc   ;==>_QPDF_LastError_Set

Func _QPDF_LastError_GetCode($iError = @error, $iExtended = @extended)
    Local $oQP = Default ; fake object - to get code
    Return SetError($iError, $iExtended, _QPDF_LastError_SetCode($oQP))
EndFunc   ;==>_QPDF_LastError_GetCode

Func _QPDF_LastError_GetDescription($iError = @error, $iExtended = @extended)
    Local $oQP = Default ; fake object - to get description
    Return SetError($iError, $iExtended, _QPDF_LastError_SetDescription($oQP))
EndFunc   ;==>_QPDF_LastError_GetDescription

Func _QPDF_LastError_ReSet($iError = @error, $iExtended = @extended)
    Local $oQP = Null ; Fake object to Reset
    _QPDF_LastError_SetCode($oQP)
    _QPDF_LastError_SetDescription($oQP)
    Return SetError($iError, $iExtended, $QPDF_RET_DEFAULT)
EndFunc   ;==>_QPDF_LastError_ReSet

used like this:

Func _QPDF_CreateObjectFromStream(ByRef $dPDF_Stream, $sPDF_Password = '')
    Local $oQP
    If _QPDF_CreateObjectAndUnlock($oQP) <> $QPDF_RET_VALID_COMMERCIAL Then Return SetError(@error, @extended, $QPDF_RET_FAILURE)

    __QPDF_IsStream($dPDF_Stream)
    If @error Then Return SetError(@error, $QPDF_EXT_PARAM2, $QPDF_RET_FAILURE)

    If $oQP.LoadFromVariant($dPDF_Stream, $sPDF_Password) = 1 Then _
            Return SetError($QPDF_ERR_SUCCESS, $QPDF_EXT_DEFAULT, $oQP)
    _QPDF_LastError_Set($oQP)
    Return SetError($QPDF_ERR_STREAMCANNOTBELOADED, _QPDF_LastError_GetCode(), $QPDF_RET_FAILURE)
EndFunc   ;==>_QPDF_CreateObjectFromStream

 

Edited by mLipok

Signature beginning:
Please remember: "AutoIt"..... *  Wondering who uses AutoIt and what it can be used for ? * Forum Rules *
ADO.au3 UDF * POP3.au3 UDF * XML.au3 UDF * IE on Windows 11 * How to ask ChatGPT for AutoIt Codefor other useful stuff click the following button:

Spoiler

Any of my own code posted anywhere on the forum is available for use by others without any restriction of any kind. 

My contribution (my own projects): * Debenu Quick PDF Library - UDF * Debenu PDF Viewer SDK - UDF * Acrobat Reader - ActiveX Viewer * UDF for PDFCreator v1.x.x * XZip - UDF * AppCompatFlags UDF * CrowdinAPI UDF * _WinMergeCompare2Files() * _JavaExceptionAdd() * _IsBeta() * Writing DPI Awareness App - workaround * _AutoIt_RequiredVersion() * Chilkatsoft.au3 UDF * TeamViewer.au3 UDF * JavaManagement UDF * VIES over SOAP * WinSCP UDF * GHAPI UDF - modest begining - comunication with GitHub REST APIErrorLog.au3 UDF - A logging Library * Include Dependency Tree (Tool for analyzing script relations) * Show_Macro_Values.au3 *

 

My contribution to others projects or UDF based on  others projects: * _sql.au3 UDF  * POP3.au3 UDF *  RTF Printer - UDF * XML.au3 UDF * ADO.au3 UDF SMTP Mailer UDF * Dual Monitor resolution detection * * 2GUI on Dual Monitor System * _SciLexer.au3 UDF * SciTE - Lexer for console pane

Useful links: * Forum Rules * Forum etiquette *  Forum Information and FAQs * How to post code on the forum * AutoIt Online Documentation * AutoIt Online Beta Documentation * SciTE4AutoIt3 getting started * Convert text blocks to AutoIt code * Games made in Autoit * Programming related sites * Polish AutoIt Tutorial * DllCall Code Generator * 

Wiki: Expand your knowledge - AutoIt Wiki * Collection of User Defined Functions * How to use HelpFile * Good coding practices in AutoIt * 

OpenOffice/LibreOffice/XLS Related: WriterDemo.au3 * XLS/MDB from scratch with ADOX

IE Related:  * How to use IE.au3  UDF with  AutoIt v3.3.14.x * Why isn't Autoit able to click a Javascript Dialog? * Clicking javascript button with no ID * IE document >> save as MHT file * IETab Switcher (by LarsJ ) * HTML Entities * _IEquerySelectorAll() (by uncommon) * IE in TaskSchedulerIE Embedded Control Versioning (use IE9+ and HTML5 in a GUI) * PDF Related:How to get reference to PDF object embeded in IE * IE on Windows 11

I encourage you to read: * Global Vars * Best Coding Practices * Please explain code used in Help file for several File functions * OOP-like approach in AutoIt * UDF-Spec Questions *  EXAMPLE: How To Catch ConsoleWrite() output to a file or to CMD *

I also encourage you to check awesome @trancexx code:  * Create COM objects from modules without any demand on user to register anything. * Another COM object registering stuffOnHungApp handlerAvoid "AutoIt Error" message box in unknown errors  * HTML editor

winhttp.au3 related : * https://www.autoitscript.com/forum/topic/206771-winhttpau3-download-problem-youre-speaking-plain-http-to-an-ssl-enabled-server-port/

"Homo sum; humani nil a me alienum puto" - Publius Terentius Afer
"Program are meant to be read by humans and only incidentally for computers and execute" - Donald Knuth, "The Art of Computer Programming"
:naughty:  :ranting:, be  :) and       \\//_.

Anticipating Errors :  "Any program that accepts data from a user must include code to validate that data before sending it to the data store. You cannot rely on the data store, ...., or even your programming language to notify you of problems. You must check every byte entered by your users, making sure that data is the correct type for its field and that required fields are not empty."

Signature last update: 2023-04-24

Link to comment
Share on other sites

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now
 Share

  • Recently Browsing   0 members

    • No registered users viewing this page.
×
×
  • Create New...