Created
January 24, 2020 20:06
-
-
Save marcinotorowski/8c09fc556469b22a9df421be51e370b2 to your computer and use it in GitHub Desktop.
A simple PowerShell class which converts HRESULT into a human-friendly error
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| class ActualError { | |
| [int]$HResult; | |
| [string]$HResultHex; | |
| [string]$HResultBin; | |
| [string]$Facility; | |
| [int]$FacilityCode; | |
| [int]$ErrorCode; | |
| [bool]$IsFailure; | |
| [string]$Message; | |
| [bool]$IsCustom; | |
| [bool]$IsServerFailure; | |
| } | |
| function Get-ActualError | |
| { | |
| param([int]$hresult) | |
| $actualError = [ActualError]::new(); | |
| $actualError.HResult = $hresult; | |
| $actualError.HResultBin = [System.Convert]::ToString($hresult,2).PadLeft(32,'0'); | |
| $actualError.HResultHex = "0x" + $hresult.ToString("X2"); | |
| $actualError.Message = (New-Object System.ComponentModel.Win32Exception($hresult)).Message; | |
| $actualError.ErrorCode = $hresult -band 0xFFFF; | |
| $hresult = $hresult -shr 16; | |
| $actualError.FacilityCode = $hresult -band 0x7FF; | |
| $hresult = $hresult -shr 11; | |
| $hresult = $hresult -shr 1; | |
| $hresult = $hresult -shr 1; | |
| $actualError.IsCustom = ($hresult -band 1) -eq 1; | |
| $hresult = $hresult -shr 1; | |
| $actualError.IsServerFailure = ($hresult -band 1) -eq 1; | |
| $hresult = $hresult -shr 1; | |
| $actualError.IsFailure = ($hresult -band 1) -eq 1; | |
| $actualError.Facility = switch ($actualError.FacilityCode) | |
| { | |
| 0 { 'FACILITY_NULL'; } | |
| 1 { 'FACILITY_RPC'; } | |
| 2 { 'FACILITY_DISPATCH'; } | |
| 3 { 'FACILITY_STORAGE'; } | |
| 4 { 'FACILITY_ITF'; } | |
| 7 { 'FACILITY_WIN32'; } | |
| 8 { 'FACILITY_WINDOWS'; } | |
| 9 { 'FACILITY_SECURITY'; } | |
| 9 { 'FACILITY_SSPI'; } | |
| 10 { 'FACILITY_CONTROL'; } | |
| 11 { 'FACILITY_CERT'; } | |
| 12 { 'FACILITY_INTERNET'; } | |
| 13 { 'FACILITY_MEDIASERVER'; } | |
| 14 { 'FACILITY_MSMQ'; } | |
| 15 { 'FACILITY_SETUPAPI'; } | |
| 16 { 'FACILITY_SCARD'; } | |
| 17 { 'FACILITY_COMPLUS'; } | |
| 18 { 'FACILITY_AAF'; } | |
| 19 { 'FACILITY_URT'; } | |
| 20 { 'FACILITY_ACS'; } | |
| 21 { 'FACILITY_DPLAY'; } | |
| 22 { 'FACILITY_UMI'; } | |
| 23 { 'FACILITY_SXS'; } | |
| 24 { 'FACILITY_WINDOWS_CE'; } | |
| 25 { 'FACILITY_HTTP'; } | |
| 26 { 'FACILITY_USERMODE_COMMONLOG'; } | |
| 27 { 'FACILITY_WER'; } | |
| 31 { 'FACILITY_USERMODE_FILTER_MANAGER'; } | |
| 32 { 'FACILITY_BACKGROUNDCOPY'; } | |
| 33 { 'FACILITY_CONFIGURATION'; } | |
| 33 { 'FACILITY_WIA'; } | |
| 34 { 'FACILITY_STATE_MANAGEMENT'; } | |
| 35 { 'FACILITY_METADIRECTORY'; } | |
| 36 { 'FACILITY_WINDOWSUPDATE'; } | |
| 37 { 'FACILITY_DIRECTORYSERVICE'; } | |
| 38 { 'FACILITY_GRAPHICS'; } | |
| 39 { 'FACILITY_NAP'; } | |
| 39 { 'FACILITY_SHELL'; } | |
| 40 { 'FACILITY_TPM_SERVICES'; } | |
| 41 { 'FACILITY_TPM_SOFTWARE'; } | |
| 42 { 'FACILITY_UI'; } | |
| 43 { 'FACILITY_XAML'; } | |
| 44 { 'FACILITY_ACTION_QUEUE'; } | |
| 48 { 'FACILITY_PLA'; } | |
| 48 { 'FACILITY_WINDOWS_SETUP'; } | |
| 49 { 'FACILITY_FVE'; } | |
| 50 { 'FACILITY_FWP'; } | |
| 51 { 'FACILITY_WINRM'; } | |
| 52 { 'FACILITY_NDIS'; } | |
| 53 { 'FACILITY_USERMODE_HYPERVISOR'; } | |
| 54 { 'FACILITY_CMI'; } | |
| 55 { 'FACILITY_USERMODE_VIRTUALIZATION'; } | |
| 56 { 'FACILITY_USERMODE_VOLMGR'; } | |
| 57 { 'FACILITY_BCD'; } | |
| 58 { 'FACILITY_USERMODE_VHD'; } | |
| 60 { 'FACILITY_SDIAG'; } | |
| 61 { 'FACILITY_WEBSERVICES'; } | |
| 61 { 'FACILITY_WINPE'; } | |
| 62 { 'FACILITY_WPN'; } | |
| 63 { 'FACILITY_WINDOWS_STORE'; } | |
| 64 { 'FACILITY_INPUT'; } | |
| 66 { 'FACILITY_EAP'; } | |
| 80 { 'FACILITY_WINDOWS_DEFENDER'; } | |
| 81 { 'FACILITY_OPC'; } | |
| 82 { 'FACILITY_XPS'; } | |
| 83 { 'FACILITY_RAS'; } | |
| 84 { 'FACILITY_MBN'; } | |
| 84 { 'FACILITY_POWERSHELL'; } | |
| 85 { 'FACILITY_EAS'; } | |
| 98 { 'FACILITY_P2P_INT'; } | |
| 99 { 'FACILITY_P2P'; } | |
| 100 { 'FACILITY_DAF'; } | |
| 101 { 'FACILITY_BLUETOOTH_ATT'; } | |
| 102 { 'FACILITY_AUDIO'; } | |
| 109 { 'FACILITY_VISUALCPP'; } | |
| 112 { 'FACILITY_SCRIPT'; } | |
| 113 { 'FACILITY_PARSE'; } | |
| 120 { 'FACILITY_BLB'; } | |
| 121 { 'FACILITY_BLB_CLI'; } | |
| 122 { 'FACILITY_WSBAPP'; } | |
| 128 { 'FACILITY_BLBUI'; } | |
| 129 { 'FACILITY_USN'; } | |
| 130 { 'FACILITY_USERMODE_VOLSNAP'; } | |
| 131 { 'FACILITY_TIERING'; } | |
| 133 { 'FACILITY_WSB_ONLINE'; } | |
| 134 { 'FACILITY_ONLINE_ID'; } | |
| 153 { 'FACILITY_DLS'; } | |
| 160 { 'FACILITY_SOS'; } | |
| 176 { 'FACILITY_DEBUGGERS'; } | |
| 231 { 'FACILITY_USERMODE_SPACES'; } | |
| 256 { 'FACILITY_DMSERVER'; } | |
| 256 { 'FACILITY_RESTORE'; } | |
| 256 { 'FACILITY_SPP'; } | |
| 257 { 'FACILITY_DEPLOYMENT_SERVICES_SERVER'; } | |
| 258 { 'FACILITY_DEPLOYMENT_SERVICES_IMAGING'; } | |
| 259 { 'FACILITY_DEPLOYMENT_SERVICES_MANAGEMENT'; } | |
| 260 { 'FACILITY_DEPLOYMENT_SERVICES_UTIL'; } | |
| 261 { 'FACILITY_DEPLOYMENT_SERVICES_BINLSVC'; } | |
| 263 { 'FACILITY_DEPLOYMENT_SERVICES_PXE'; } | |
| 264 { 'FACILITY_DEPLOYMENT_SERVICES_TFTP'; } | |
| 272 { 'FACILITY_DEPLOYMENT_SERVICES_TRANSPORT_MANAGEMENT'; } | |
| 278 { 'FACILITY_DEPLOYMENT_SERVICES_DRIVER_PROVISIONING'; } | |
| 289 { 'FACILITY_DEPLOYMENT_SERVICES_MULTICAST_SERVER'; } | |
| 290 { 'FACILITY_DEPLOYMENT_SERVICES_MULTICAST_CLIENT'; } | |
| 293 { 'FACILITY_DEPLOYMENT_SERVICES_CONTENT_PROVIDER'; } | |
| 305 { 'FACILITY_LINGUISTIC_SERVICES'; } | |
| 885 { 'FACILITY_WEB'; } | |
| 886 { 'FACILITY_WEB_SOCKET'; } | |
| 1094 { 'FACILITY_AUDIOSTREAMING'; } | |
| 1536 { 'FACILITY_ACCELERATOR'; } | |
| 1793 { 'FACILITY_MOBILE'; } | |
| 1996 { 'FACILITY_WMAAECMA'; } | |
| 2049 { 'FACILITY_WEP'; } | |
| 2050 { 'FACILITY_SYNCENGINE'; } | |
| 2168 { 'FACILITY_DIRECTMUSIC'; } | |
| 2169 { 'FACILITY_DIRECT3D10'; } | |
| 2170 { 'FACILITY_DXGI'; } | |
| 2171 { 'FACILITY_DXGI_DDI'; } | |
| 2172 { 'FACILITY_DIRECT3D11'; } | |
| 2184 { 'FACILITY_LEAP'; } | |
| 2185 { 'FACILITY_AUDCLNT'; } | |
| 2200 { 'FACILITY_WINCODEC_DWRITE_DWM'; } | |
| 2201 { 'FACILITY_DIRECT2D'; } | |
| 2304 { 'FACILITY_DEFRAG'; } | |
| 2305 { 'FACILITY_USERMODE_SDBUS'; } | |
| 2306 { 'FACILITY_JSCRIPT'; } | |
| 2561 { 'FACILITY_PIDGENX'; } | |
| } | |
| return $actualError; | |
| } |
Author
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Usage:
Get-ActualError 0x800706BAResult:
HResult : -2147023174HResultHex : 0x800706BAHResultBin : 10000000000001110000011010111010Facility : FACILITY_WIN32FacilityCode : 7ErrorCode : 1722IsFailure : TrueMessage : RPC server is unavailableIsCustom : FalseIsServerFailure : False