nt_code.hpp 8.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251
  1. /* Proposed SG14 status_code
  2. (C) 2018-2025 Niall Douglas <http://www.nedproductions.biz/> (5 commits)
  3. File Created: Feb 2018
  4. Boost Software License - Version 1.0 - August 17th, 2003
  5. Permission is hereby granted, free of charge, to any person or organization
  6. obtaining a copy of the software and accompanying documentation covered by
  7. this license (the "Software") to use, reproduce, display, distribute,
  8. execute, and transmit the Software, and to prepare derivative works of the
  9. Software, and to permit third-parties to whom the Software is furnished to
  10. do so, all subject to the following:
  11. The copyright notices in the Software and this entire statement, including
  12. the above license grant, this restriction and the following disclaimer,
  13. must be included in all copies of the Software, in whole or in part, and
  14. all derivative works of the Software, unless such copies or derivative
  15. works are solely in the form of machine-executable object code generated by
  16. a source language processor.
  17. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  18. IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  19. FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
  20. SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
  21. FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
  22. ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  23. DEALINGS IN THE SOFTWARE.
  24. */
  25. #ifndef BOOST_OUTCOME_SYSTEM_ERROR2_NT_CODE_HPP
  26. #define BOOST_OUTCOME_SYSTEM_ERROR2_NT_CODE_HPP
  27. #if !defined(_WIN32) && !defined(BOOST_OUTCOME_STANDARDESE_IS_IN_THE_HOUSE)
  28. #error This file should only be included on Windows
  29. #endif
  30. #include "win32_code.hpp"
  31. #if defined(_MSC_VER) && !defined(__clang__)
  32. #pragma warning(push)
  33. #pragma warning(disable : 6326) // constant comparison
  34. #endif
  35. BOOST_OUTCOME_SYSTEM_ERROR2_NAMESPACE_BEGIN
  36. //! \exclude
  37. namespace win32
  38. {
  39. #ifdef __MINGW32__
  40. extern "C"
  41. {
  42. #endif
  43. // A Win32 NTSTATUS
  44. using NTSTATUS = long;
  45. // A Win32 HMODULE
  46. using HMODULE = void *;
  47. // Used to retrieve where the NTDLL DLL is mapped into memory
  48. extern HMODULE __stdcall GetModuleHandleW(const wchar_t *lpModuleName);
  49. #ifdef __MINGW32__
  50. }
  51. #else
  52. #pragma comment(lib, "kernel32.lib")
  53. #if(defined(__x86_64__) || defined(_M_X64)) || (defined(__aarch64__) || defined(_M_ARM64))
  54. #pragma comment(linker, "/alternatename:?GetModuleHandleW@win32@system_error2@@YAPEAXPEB_W@Z=GetModuleHandleW")
  55. #elif defined(__x86__) || defined(_M_IX86) || defined(__i386__)
  56. #pragma comment(linker, "/alternatename:?GetModuleHandleW@win32@system_error2@@YGPAXPB_W@Z=_GetModuleHandleW@4")
  57. #elif defined(__arm__) || defined(_M_ARM)
  58. #pragma comment(linker, "/alternatename:?GetModuleHandleW@win32@system_error2@@YAPAXPB_W@Z=GetModuleHandleW")
  59. #else
  60. #error Unknown architecture
  61. #endif
  62. #endif
  63. } // namespace win32
  64. class _nt_code_domain;
  65. //! (Windows only) A NT error code, those returned by NT kernel functions.
  66. using nt_code = status_code<_nt_code_domain>;
  67. //! (Windows only) A specialisation of `status_error` for the NT error code domain.
  68. using nt_error = status_error<_nt_code_domain>;
  69. /*! (Windows only) The implementation of the domain for NT error codes, those returned by NT kernel functions.
  70. */
  71. class _nt_code_domain : public status_code_domain
  72. {
  73. template <class DomainType> friend class status_code;
  74. friend class _com_code_domain;
  75. using _base = status_code_domain;
  76. static int _nt_code_to_errno(win32::NTSTATUS c)
  77. {
  78. if(c >= 0)
  79. {
  80. return 0; // success
  81. }
  82. switch(static_cast<unsigned>(c))
  83. {
  84. #include "detail/nt_code_to_generic_code.ipp"
  85. }
  86. return -1;
  87. }
  88. static win32::DWORD _nt_code_to_win32_code(win32::NTSTATUS c) // NOLINT
  89. {
  90. if(c >= 0)
  91. {
  92. return 0; // success
  93. }
  94. switch(static_cast<unsigned>(c))
  95. {
  96. #include "detail/nt_code_to_win32_code.ipp"
  97. }
  98. return static_cast<win32::DWORD>(-1);
  99. }
  100. //! Construct from a NT error code
  101. static _base::string_ref _make_string_ref(win32::NTSTATUS c) noexcept
  102. {
  103. wchar_t buffer[32768];
  104. static win32::HMODULE ntdll = win32::GetModuleHandleW(L"NTDLL.DLL");
  105. win32::DWORD wlen =
  106. win32::FormatMessageW(0x00000800 /*FORMAT_MESSAGE_FROM_HMODULE*/ | 0x00001000 /*FORMAT_MESSAGE_FROM_SYSTEM*/ | 0x00000200 /*FORMAT_MESSAGE_IGNORE_INSERTS*/,
  107. ntdll, c, (1 << 10) /*MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT)*/, buffer, 32768, nullptr);
  108. size_t allocation = wlen + (wlen >> 1);
  109. win32::DWORD bytes;
  110. if(wlen == 0)
  111. {
  112. return _base::string_ref("failed to get message from system");
  113. }
  114. for(;;)
  115. {
  116. auto *p = static_cast<char *>(malloc(allocation)); // NOLINT
  117. if(p == nullptr)
  118. {
  119. return _base::string_ref("failed to get message from system");
  120. }
  121. bytes = win32::WideCharToMultiByte(65001 /*CP_UTF8*/, 0, buffer, (int) (wlen + 1), p, (int) allocation, nullptr, nullptr);
  122. if(bytes != 0)
  123. {
  124. char *end = strchr(p, 0);
  125. while(end[-1] == 10 || end[-1] == 13)
  126. {
  127. --end;
  128. }
  129. *end = 0; // NOLINT
  130. return _base::atomic_refcounted_string_ref(p, end - p);
  131. }
  132. free(p); // NOLINT
  133. if(win32::GetLastError() == 0x7a /*ERROR_INSUFFICIENT_BUFFER*/)
  134. {
  135. allocation += allocation >> 2;
  136. continue;
  137. }
  138. return _base::string_ref("failed to get message from system");
  139. }
  140. }
  141. public:
  142. //! The value type of the NT code, which is a `win32::NTSTATUS`
  143. using value_type = win32::NTSTATUS;
  144. using _base::string_ref;
  145. public:
  146. //! Default constructor
  147. constexpr explicit _nt_code_domain(typename _base::unique_id_type id = 0x93f3b4487e4af25b) noexcept
  148. : _base(id)
  149. {
  150. }
  151. _nt_code_domain(const _nt_code_domain &) = default;
  152. _nt_code_domain(_nt_code_domain &&) = default;
  153. _nt_code_domain &operator=(const _nt_code_domain &) = default;
  154. _nt_code_domain &operator=(_nt_code_domain &&) = default;
  155. ~_nt_code_domain() = default;
  156. //! Constexpr singleton getter. Returns the constexpr nt_code_domain variable.
  157. static inline constexpr const _nt_code_domain &get();
  158. virtual string_ref name() const noexcept override { return string_ref("NT domain"); } // NOLINT
  159. virtual payload_info_t payload_info() const noexcept override
  160. {
  161. return {sizeof(value_type), sizeof(status_code_domain *) + sizeof(value_type),
  162. (alignof(value_type) > alignof(status_code_domain *)) ? alignof(value_type) : alignof(status_code_domain *)};
  163. }
  164. protected:
  165. virtual bool _do_failure(const status_code<void> &code) const noexcept override // NOLINT
  166. {
  167. assert(code.domain() == *this);
  168. return static_cast<const nt_code &>(code).value() < 0; // NOLINT
  169. }
  170. virtual bool _do_equivalent(const status_code<void> &code1, const status_code<void> &code2) const noexcept override // NOLINT
  171. {
  172. assert(code1.domain() == *this);
  173. const auto &c1 = static_cast<const nt_code &>(code1); // NOLINT
  174. if(code2.domain() == *this)
  175. {
  176. const auto &c2 = static_cast<const nt_code &>(code2); // NOLINT
  177. return c1.value() == c2.value();
  178. }
  179. if(code2.domain() == generic_code_domain)
  180. {
  181. const auto &c2 = static_cast<const generic_code &>(code2); // NOLINT
  182. if(static_cast<int>(c2.value()) == _nt_code_to_errno(c1.value()))
  183. {
  184. return true;
  185. }
  186. }
  187. if(code2.domain() == win32_code_domain)
  188. {
  189. const auto &c2 = static_cast<const win32_code &>(code2); // NOLINT
  190. if(c2.value() == _nt_code_to_win32_code(c1.value()))
  191. {
  192. return true;
  193. }
  194. }
  195. return false;
  196. }
  197. virtual generic_code _generic_code(const status_code<void> &code) const noexcept override // NOLINT
  198. {
  199. assert(code.domain() == *this);
  200. const auto &c = static_cast<const nt_code &>(code); // NOLINT
  201. return generic_code(static_cast<errc>(_nt_code_to_errno(c.value())));
  202. }
  203. virtual string_ref _do_message(const status_code<void> &code) const noexcept override // NOLINT
  204. {
  205. assert(code.domain() == *this);
  206. const auto &c = static_cast<const nt_code &>(code); // NOLINT
  207. return _make_string_ref(c.value());
  208. }
  209. #if defined(_CPPUNWIND) || defined(__EXCEPTIONS) || defined(BOOST_OUTCOME_STANDARDESE_IS_IN_THE_HOUSE)
  210. BOOST_OUTCOME_SYSTEM_ERROR2_NORETURN virtual void _do_throw_exception(const status_code<void> &code) const override // NOLINT
  211. {
  212. assert(code.domain() == *this);
  213. const auto &c = static_cast<const nt_code &>(code); // NOLINT
  214. throw status_error<_nt_code_domain>(c);
  215. }
  216. #endif
  217. };
  218. //! (Windows only) A constexpr source variable for the NT code domain, which is that of NT kernel functions. Returned by `_nt_code_domain::get()`.
  219. constexpr _nt_code_domain nt_code_domain;
  220. inline constexpr const _nt_code_domain &_nt_code_domain::get()
  221. {
  222. return nt_code_domain;
  223. }
  224. BOOST_OUTCOME_SYSTEM_ERROR2_NAMESPACE_END
  225. #if defined(_MSC_VER) && !defined(__clang__)
  226. #pragma warning(pop)
  227. #endif
  228. #endif