windows_error 0.1.5 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37e364f4623b1af47ff8280b2f2dcd6c025b92860fa7661cfd8a6e7f5e5a1704
-  data.tar.gz: 697e8d708b14d497cb3d94f666abbd2f78631a2ad3462feceeb80c1abb73f53e
+  metadata.gz: c1d3c04128d9c2ebf7855feb8ff5fddaf4225853da8a999936dedc3ae29403e4
+  data.tar.gz: 19c66d7aeec6e9aed8dbc8c780b22e5df985ca71d12de5827710ad7fcf0bd810
 SHA512:
-  metadata.gz: f765e1dc23dcec3b505b7780f0e49288d51422163f02a28190d93b8ddab7b5073c474b3a88616c0629b1afdd23e21183dea6f93ea97cf7b6761029bdf5f754bc
-  data.tar.gz: cc0a06b0ba5575d4c7a068160b32d495116d12efe8dd60285d3c4737bca63a5397bdb60f6609ca1f53670b906d9a87760195d0f89045d7ff701e39074cd2f7b2
+  metadata.gz: aae7293ae0618d9a95fbe121143cfd203f4d73d6a36d0d41902610fb93b75bc7802f20333e5f2abb8d35f7c72fe59f3165370353b5424600e25b226e96c6e281
+  data.tar.gz: 575c180ae7047495707acf5ecc6084b408b3199cf13679c56a59ffdf92c142474abfcc3ad4b05b04ad8acaa0d48e2b8d08223d851a3e35a36dd3973001400d73

data/cortex.yaml

@@ -0,0 +1,16 @@
+---
+info:
+  title: Windows Error
+  x-cortex-git:
+    github:
+      alias: r7org
+      repository: rapid7/windows_error
+  x-cortex-tag: windows-error
+  x-cortex-type: service
+  x-cortex-domain-parents:
+  - tag: metasploit
+  x-cortex-groups:
+  - exposure:external-ship
+openapi: 3.0.1
+servers:
+- url: "/"

data/lib/windows_error/h_result/facility.rb

@@ -36,10 +36,19 @@ module WindowsError
 
         self.constants.sort.each do |constant_name|
           facility_code = self.const_get(constant_name)
+          next unless facility_code.kind_of?(FacilityCode)
+
           if facility_code.value == retval
             return facility_code
           end
         end
+        nil
+      end
+
+      def self.find_by_h_result(retval)
+        raise ArgumentError, "Invalid value!" unless retval.kind_of? Integer
+
+        self.find_by_code((retval >> 16) & 0x1fff)
       end
 
       # (0x0000) The default facility code.

data/lib/windows_error/h_result.rb

@@ -5,16 +5,23 @@ module WindowsError
   # for more details on this particular set of error codes.
   module HResult
 
+    require 'windows_error'
     require 'windows_error/h_result/facility'
+    require 'windows_error/win32'
 
     # Returns all the {HResultCode} objects that match
     # the return value supplied.
     #
     # @param [Integer] retval the return value you want the error code for
     # @raise [ArgumentError] if something other than a Integer is supplied
-    # @return [Array<HResultCode>] all Win32 ErrorCodes that matched
+    # @return [Array<WindowsError::ErrorCode>] all ErrorCodes that matched
     def self.find_by_retval(retval)
       raise ArgumentError, "Invalid value!" unless retval.kind_of? Integer
+
+      if Facility.find_by_h_result(retval) == Facility::FACILITY_WIN32.value
+        return Win32.find_by_retval(retval & 0xffff)
+      end
+
       error_codes = []
       self.constants.sort.each do |constant_name|
         error_code = self.const_get(constant_name)

data/lib/windows_error/nt_status.rb

@@ -5,6 +5,8 @@ module WindowsError
   # more details on this particular set of error codes.
   module NTStatus
 
+    require 'windows_error'
+
     # Returns all the {WindowsError::ErrorCode} objects that match
     # the return value supplied.
     #

data/lib/windows_error/version.rb

@@ -1,3 +1,3 @@
 module WindowsError
-  VERSION = "0.1.5"
+  VERSION = "0.1.6"
 end

data/lib/windows_error/win32.rb

@@ -5,6 +5,8 @@ module WindowsError
   # more details on this particular set of error codes.
   module Win32
 
+    require 'windows_error'
+
     # Returns all the {WindowsError::ErrorCode} objects that match
     # the return value supplied.
     #

data/spec/lib/windows_error/h_result/facility_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+require 'windows_error/h_result/facility'
+
+describe WindowsError::HResult::Facility do
+
+  describe '#find_by_code' do
+
+    it 'raises an argument error when passed an invalid value' do
+      expect { WindowsError::HResult::Facility.find_by_code('foo') }.to raise_error ArgumentError, 'Invalid value!'
+    end
+
+    it 'returns the facility code for the supplied value' do
+      expect(WindowsError::HResult::Facility.find_by_code(0x0007)).to eq WindowsError::HResult::Facility::FACILITY_WIN32
+    end
+
+    it 'returns nil if there is no matching facility code' do
+      expect(WindowsError::HResult::Facility.find_by_code(0x0fff)).to be_nil
+    end
+  end
+
+  describe '#find_by_h_result' do
+
+    it 'raises an argument error when passed an invalid value' do
+      expect { WindowsError::HResult::Facility.find_by_h_result('foo') }.to raise_error ArgumentError, 'Invalid value!'
+    end
+
+    it 'returns the facility code embedded in an HRESULT' do
+      expect(WindowsError::HResult::Facility.find_by_h_result(0x80070547)).to eq WindowsError::HResult::Facility::FACILITY_WIN32
+    end
+
+    it 'returns nil if there is no matching facility code' do
+      expect(WindowsError::HResult::Facility.find_by_h_result(0x8fff0547)).to be_nil
+    end
+  end
+end

data/spec/lib/windows_error/h_result_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+require 'windows_error/h_result'
+
+describe WindowsError::HResult do
+
+  describe '#find_by_retval' do
+
+    it 'raises an argument error when passed an invalid value' do
+      expect { WindowsError::HResult.find_by_retval('foo') }.to raise_error ArgumentError, 'Invalid value!'
+    end
+
+    it 'maps FACILITY_WIN32 HRESULTs to Win32 error codes' do
+      expect(WindowsError::HResult.find_by_retval(0x80070547)).to match_array([WindowsError::Win32::ERROR_CANT_ACCESS_DOMAIN_INFO])
+    end
+
+    it 'returns HRESULT error codes for non-Win32 facilities' do
+      expect(WindowsError::HResult.find_by_retval(0x800401f3)).to match_array([WindowsError::HResult::CO_E_CLASSSTRING])
+    end
+
+    it 'returns an empty array if there is no match' do
+      expect(WindowsError::HResult.find_by_retval(0xffffffff)).to match_array([])
+    end
+  end
+end

metadata

@@ -1,99 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: windows_error
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors:
 - David Maloney
-autorequire: 
+autorequire:
 bindir: bin
-cert_chain:
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIDtzCCAp+gAwIBAgIQDOfg5RfYRv6P5WD8G/AwOTANBgkqhkiG9w0BAQUFADBl
-  MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
-  d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv
-  b3QgQ0EwHhcNMDYxMTEwMDAwMDAwWhcNMzExMTEwMDAwMDAwWjBlMQswCQYDVQQG
-  EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl
-  cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgQ0EwggEi
-  MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCtDhXO5EOAXLGH87dg+XESpa7c
-  JpSIqvTO9SA5KFhgDPiA2qkVlTJhPLWxKISKityfCgyDF3qPkKyK53lTXDGEKvYP
-  mDI2dsze3Tyoou9q+yHyUmHfnyDXH+Kx2f4YZNISW1/5WBg1vEfNoTb5a3/UsDg+
-  wRvDjDPZ2C8Y/igPs6eD1sNuRMBhNZYW/lmci3Zt1/GiSw0r/wty2p5g0I6QNcZ4
-  VYcgoc/lbQrISXwxmDNsIumH0DJaoroTghHtORedmTpyoeb6pNnVFzF1roV9Iq4/
-  AUaG9ih5yLHa5FcXxH4cDrC0kqZWs72yl+2qp/C3xag/lRbQ/6GW6whfGHdPAgMB
-  AAGjYzBhMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW
-  BBRF66Kv9JLLgjEtUYunpyGd823IDzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYun
-  pyGd823IDzANBgkqhkiG9w0BAQUFAAOCAQEAog683+Lt8ONyc3pklL/3cmbYMuRC
-  dWKuh+vy1dneVrOfzM4UKLkNl2BcEkxY5NM9g0lFWJc1aRqoR+pWxnmrEthngYTf
-  fwk8lOa4JiwgvT2zKIn3X/8i4peEH+ll74fg38FnSbNd67IJKusm7Xi+fT8r87cm
-  NW1fiQG2SVufAQWbqz0lwcy2f8Lxb4bG+mRo64EtlOtCt/qMHt1i8b5QZ7dsvfPx
-  H2sMNgcWfzd8qVttevESRmCD1ycEvkvOl77DZypoEd+A5wwzZr8TDRRu838fYxAe
-  +o0bJW1sj6W3YQGx0qMmoRBxna3iw/nDmVG3KwcIzi7mULKn+gpFL6Lw8g==
-  -----END CERTIFICATE-----
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIFMDCCBBigAwIBAgIQBAkYG1/Vu2Z1U0O1b5VQCDANBgkqhkiG9w0BAQsFADBl
-  MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
-  d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv
-  b3QgQ0EwHhcNMTMxMDIyMTIwMDAwWhcNMjgxMDIyMTIwMDAwWjByMQswCQYDVQQG
-  EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl
-  cnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFzc3VyZWQgSUQgQ29kZSBT
-  aWduaW5nIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA+NOzHH8O
-  Ea9ndwfTCzFJGc/Q+0WZsTrbRPV/5aid2zLXcep2nQUut4/6kkPApfmJ1DcZ17aq
-  8JyGpdglrA55KDp+6dFn08b7KSfH03sjlOSRI5aQd4L5oYQjZhJUM1B0sSgmuyRp
-  wsJS8hRniolF1C2ho+mILCCVrhxKhwjfDPXiTWAYvqrEsq5wMWYzcT6scKKrzn/p
-  fMuSoeU7MRzP6vIK5Fe7SrXpdOYr/mzLfnQ5Ng2Q7+S1TqSp6moKq4TzrGdOtcT3
-  jNEgJSPrCGQ+UpbB8g8S9MWOD8Gi6CxR93O8vYWxYoNzQYIH5DiLanMg0A9kczye
-  n6Yzqf0Z3yWT0QIDAQABo4IBzTCCAckwEgYDVR0TAQH/BAgwBgEB/wIBADAOBgNV
-  HQ8BAf8EBAMCAYYwEwYDVR0lBAwwCgYIKwYBBQUHAwMweQYIKwYBBQUHAQEEbTBr
-  MCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wQwYIKwYBBQUH
-  MAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJ
-  RFJvb3RDQS5jcnQwgYEGA1UdHwR6MHgwOqA4oDaGNGh0dHA6Ly9jcmw0LmRpZ2lj
-  ZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmwwOqA4oDaGNGh0dHA6
-  Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmww
-  TwYDVR0gBEgwRjA4BgpghkgBhv1sAAIEMCowKAYIKwYBBQUHAgEWHGh0dHBzOi8v
-  d3d3LmRpZ2ljZXJ0LmNvbS9DUFMwCgYIYIZIAYb9bAMwHQYDVR0OBBYEFFrEuXsq
-  CqOl6nEDwGD5LfZldQ5YMB8GA1UdIwQYMBaAFEXroq/0ksuCMS1Ri6enIZ3zbcgP
-  MA0GCSqGSIb3DQEBCwUAA4IBAQA+7A1aJLPzItEVyCx8JSl2qB1dHC06GsTvMGHX
-  fgtg/cM9D8Svi/3vKt8gVTew4fbRknUPUbRupY5a4l4kgU4QpO4/cY5jDhNLrddf
-  RHnzNhQGivecRk5c/5CxGwcOkRX7uq+1UcKNJK4kxscnKqEpKBo6cSgCPC6Ro8Al
-  EeKcFEehemhor5unXCBc2XGxDI+7qPjFEmifz0DLQESlE/DmZAwlCEIysjaKJAL+
-  L3J+HNdJRZboWR3p+nRka7LrZkPas7CM1ekN3fYBIM6ZMWM9CBoYs4GbT8aTEAb8
-  B4H6i9r5gkn3Ym6hU/oSlBiFLpKR6mhsRDKyZqHnGKSaZFHv
-  -----END CERTIFICATE-----
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIFIzCCBAugAwIBAgIQCMePMbkSxvnPeJhYXIfaxzANBgkqhkiG9w0BAQsFADBy
-  MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
-  d3cuZGlnaWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFzc3VyZWQg
-  SUQgQ29kZSBTaWduaW5nIENBMB4XDTIwMTAwNzAwMDAwMFoXDTIzMTEwNjEyMDAw
-  MFowYDELMAkGA1UEBhMCVVMxFjAUBgNVBAgTDU1hc3NhY2h1c2V0dHMxDzANBgNV
-  BAcTBkJvc3RvbjETMBEGA1UEChMKUmFwaWQ3IExMQzETMBEGA1UEAxMKUmFwaWQ3
-  IExMQzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALNTz4zvAy7h/vQp
-  4dr1txXHlABAagkwYYwTMCtHs5PXsJITx/5SAjx5swuaLfze5kPBNF2YImvFlOXY
-  WaB+0PsOnXnaARsDZU683xFlj8izU6IN6VrAHzDLKFBzruJENrOJD/ikbEtbjO/q
-  gFbmS9J9v5ohG/pcRSS0t4ZPAwymf8eCp6QsvOKK/Aymp1RhlRaP8N6N5CIpkhz1
-  9p968iCE+DjOXVYxcWE+jE/7uB1dbgrXykNBujMSS3GULOvVEY28n6NCmrPlo23g
-  yRjYVJ2Vy14nBqnxDZ/yRIfWRVjWoT9TsAEbe9gY29oDpSCSs4wSmLQd5zGCpZ9h
-  r0HDFB8CAwEAAaOCAcUwggHBMB8GA1UdIwQYMBaAFFrEuXsqCqOl6nEDwGD5LfZl
-  dQ5YMB0GA1UdDgQWBBTLBL7DTwumVEKtdCdpHVYMXOFeDzAOBgNVHQ8BAf8EBAMC
-  B4AwEwYDVR0lBAwwCgYIKwYBBQUHAwMwdwYDVR0fBHAwbjA1oDOgMYYvaHR0cDov
-  L2NybDMuZGlnaWNlcnQuY29tL3NoYTItYXNzdXJlZC1jcy1nMS5jcmwwNaAzoDGG
-  L2h0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9zaGEyLWFzc3VyZWQtY3MtZzEuY3Js
-  MEwGA1UdIARFMEMwNwYJYIZIAYb9bAMBMCowKAYIKwYBBQUHAgEWHGh0dHBzOi8v
-  d3d3LmRpZ2ljZXJ0LmNvbS9DUFMwCAYGZ4EMAQQBMIGEBggrBgEFBQcBAQR4MHYw
-  JAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBOBggrBgEFBQcw
-  AoZCaHR0cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0U0hBMkFzc3Vy
-  ZWRJRENvZGVTaWduaW5nQ0EuY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQEL
-  BQADggEBAN+GL5/myPWg7oH4mVrG7/OhXF1MoYQF0ddaNiqaweEHMuKJBQCVZRbL
-  37HojoKXXv2yyRJBCeTB+ojrxX+5PdLVZa0ss7toWzJ2A1poPXZ1eZvm5xeFD32z
-  YQaTmmNWNI3PCDTyJ2PXUc+bDiNNwcZ7yc5o78UNRvp9Jxghya17Q76c9Ov9wvnv
-  dxxQKWGOQy0m4fBrkyjAyH9Djjn81RbQrqYgPuhd5nD0HjN3VUQLhQbIJrk9TVs0
-  EknWpNgVhohbot1lfVAMmIhdtOVaRVcQQixWPwprDj/ydB8ryDMDosIMcw+fkoXU
-  9GJsSaSRRYQ9UUkVL27b64okU8D48m8=
-  -----END CERTIFICATE-----
-date: 2023-01-19 00:00:00.000000000 Z
+cert_chain: []
+date: 2026-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -172,6 +87,7 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- cortex.yaml
 - lib/windows_error.rb
 - lib/windows_error/error_code.rb
 - lib/windows_error/h_result.rb
@@ -180,6 +96,8 @@ files:
 - lib/windows_error/version.rb
 - lib/windows_error/win32.rb
 - spec/lib/windows_error/error_code_spec.rb
+- spec/lib/windows_error/h_result/facility_spec.rb
+- spec/lib/windows_error/h_result_spec.rb
 - spec/lib/windows_error/nt_status_spec.rb
 - spec/lib/windows_error/win32_spec.rb
 - spec/spec_helper.rb
@@ -188,7 +106,7 @@ homepage: https://github.com/rapid7/windows_error
 licenses:
 - BSD
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -203,12 +121,14 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
-signing_key: 
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
 summary: Provides a way to look up Windows NTSTATUS and Win32 Error Codes
 test_files:
 - spec/lib/windows_error/error_code_spec.rb
+- spec/lib/windows_error/h_result/facility_spec.rb
+- spec/lib/windows_error/h_result_spec.rb
 - spec/lib/windows_error/nt_status_spec.rb
 - spec/lib/windows_error/win32_spec.rb
 - spec/spec_helper.rb

checksums.yaml.gz.sig

@@ -1 +0,0 @@
-H��75��Ut���_ݖDler��R͝i�uԭR�Aa:U�B<�����~�+�G�.�� ��\z�Ҷ��Ei��V۝\�v�m�NA/��hh����q�C�;c$R�n��kA��扳�*0o�a

data.tar.gz.sig

@@ -1,2 +0,0 @@
-
q+��-b<\���|e��nP�'F��{i�fb�E��;��R���~TkUy�N-5
-�	���E�����.9���CS��9���q��-��'�7@�q��=�8e��1���y5�{����L�T���JSD�rO��2VK����;S�����@w�ɮ��䞋�ں-!O�ⴛ<�G�4�m�'y"���%qqe[��d��a� i�5����.w��g�x�3��