07 May 2021 10:32:28 UTC
- Distribution: Win32-ErrorMode
- Module version: 0.07
- Source (raw)
- Browse (raw)
- How to Contribute
- Issues (0)
- Testers (15 / 5 / 0)
- KwaliteeBus factor: 1
- % Coverage
- License: perl_5
- Perl: v5.8.0
- Activity24 month
- Download (129.67KB)
- MetaCPAN Explorer
- Subscribe to distribution
- This version
- Latest version
- SEE ALSO
- COPYRIGHT AND LICENSE
Win32::ErrorMode - Set and retrieves the error mode for the current process.
use Win32::ErrorMode qw( :all ); my $error_mode = GetErrorMode(); SetErrorMode(SEM_FAILCRITICALERRORS | SEM_NOGPFAULTERRORBOX); system "program_that_would_normal_produce_an_error_dialog.exe";
Using the thread interface (preferred):
use Win32::ErrorMode qw( :all ); # The "Thread" versions are safer if you are using threads, # which includes the use of fork() on Windows. my $error_mode = GetThreadErrorMode(); SetThreadErrorMode(SEM_FAILCRITICALERRORS | SEM_NOGPFAULTERRORBOX); system "program_that_would_normal_produce_an_error_dialog.exe";
# use "if" so that your code will still work on non-windows use if $^O eq 'MSWin32', 'Win32::ErrorMode'; # 0x3 = SEM_FAILCRITICALERRORS | SEM_NOGPFAULTERRORBOX local $Win32::ErrorMode::ErrorMode = 0x3; system "program_that_would_normal_produce_an_error_dialog.exe";
Tie interface thread:
use if $^O eq 'MSWin32', 'Win32::ErrorMode'; # 0x3 = SEM_FAILCRITICALERRORS | SEM_NOGPFAULTERRORBOX local $Win32::ErrorMode::ThreadErrorMode = 0x3; system "program_that_would_normal_produce_an_error_dialog.exe";
The main motivation for this module is to provide an interface for turning off those blasted dialog boxes when you try to run .exe with missing symbols or .dll files. This is useful when you have a long running process or a test suite where such failures are expected, or part of the configuration process.
It may have other applications.
This module also provides a tied interface
Controls whether Windows will handle the specified type of serious errors or whether the process will handle them.
$modecan be zero or more of the following values, bitwise or'd together:
Do not display the critical error message box.
Automatically fix memory alignment faults.
Do not display the windows error reporting dialog.
Do not display a message box when the system fails to find a file.
my $mode = GetErrorMode();
Retrieves the error mode for the current process.
Same as "SetErrorMode" above, except it only changes the error mode on the current thread.
my $mode = GetThreadErrorMode();
Same as "GetErrorMode" above, except it only gets the error mode for the current thread.
All of these functions are available in the oldest supported version of Windows, which is 8.1. Previous versions of this module would use dynamic loading and emulation to support some or all of the functions on older and newer systems, while maintaining binary compatibility back to Windows XP. Older versions could throw and exception for the threaded interface on older Windows systems. As of 0.07 the compatibility code has been removed: this module will only install and function on Windows 8.1 and later and all functions are fully supported.
Win32API::File includes an interface to
SetErrorMode, but not
GetErrorMode. The interface for this function appears to be a side effect of the main purpose of the module. The interface to
SetErrorModeis not well documented in Win32API::File, but is usable.
Graham Ollis <email@example.com>
This software is copyright (c) 2015 by Graham Ollis.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
Module Install Instructions
To install Win32::ErrorMode, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell install Win32::ErrorMode
For more information on module installation, please visit the detailed CPAN module installation guide.