Add Windows Version Helper functions #1050
There are no files selected for viewing
This file contains 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
This file contains 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
This file contains 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
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,218 @@ | ||
| /* Copyright (c) 2019 Daniel Widdis, All Rights Reserved | ||
| * | ||
| * The contents of this file is dual-licensed under 2 | ||
| * alternative Open Source/Free licenses: LGPL 2.1 or later and | ||
| * Apache License 2.0. (starting with JNA version 4.0.0). | ||
| * | ||
| * You can freely decide which license you want to apply to | ||
| * the project. | ||
| * | ||
| * You may obtain a copy of the LGPL License at: | ||
| * | ||
| * http://www.gnu.org/licenses/licenses.html | ||
| * | ||
| * A copy is also included in the downloadable source code package | ||
| * containing JNA, in file "LGPL2.1". | ||
| * | ||
| * You may obtain a copy of the Apache License at: | ||
| * | ||
| * http://www.apache.org/licenses/ | ||
| * | ||
| * A copy is also included in the downloadable source code package | ||
| * containing JNA, in file "AL2.0". | ||
| */ | ||
| package com.sun.jna.platform.win32; | ||
|
|
||
| import com.sun.jna.platform.win32.WinDef.DWORD; | ||
| import com.sun.jna.platform.win32.WinDef.WORD; | ||
| import com.sun.jna.platform.win32.WinNT.OSVERSIONINFOEX; | ||
|
|
||
| /** | ||
| * The following functions can be used to determine the current operating system | ||
| * version or identify whether it is a Windows or Windows Server release. These | ||
| * functions provide simple tests that use the VerifyVersionInfo function and | ||
| * the recommended greater than or equal to comparisons that are proven as a | ||
| * robust means to determine the operating system version. | ||
| */ | ||
| public class VersionHelpers { | ||
| /* | ||
| * Code in this class is an attempt to faithfully port the inline macros in | ||
| * the versionhelpers.h header file of the Windows 10 SDK. | ||
| */ | ||
|
|
||
| /** | ||
| * This function is useful in confirming a version of Windows Server that | ||
| * doesn't share a version number with a client release. You should only use | ||
| * this function if the other provided version helper functions do not fit | ||
| * your scenario. | ||
| * | ||
| * @param wMajorVersion | ||
| * The major version to test | ||
| * @param wMinorVersion | ||
| * The minor version to test | ||
| * @param wServicePackMajor | ||
| * The service pack to test | ||
| * @return True if the current OS version matches, or is greater than, the | ||
| * provided version information. | ||
| */ | ||
| public static boolean IsWindowsVersionOrGreater(int wMajorVersion, int wMinorVersion, int wServicePackMajor) { | ||
| OSVERSIONINFOEX osvi = new OSVERSIONINFOEX(); | ||
| osvi.dwOSVersionInfoSize = new DWORD(osvi.size()); | ||
| osvi.dwMajorVersion = new DWORD(wMajorVersion); | ||
| osvi.dwMinorVersion = new DWORD(wMinorVersion); | ||
| osvi.wServicePackMajor = new WORD(wServicePackMajor); | ||
|
|
||
| long dwlConditionMask = 0; | ||
| dwlConditionMask = Kernel32.INSTANCE.VerSetConditionMask(dwlConditionMask, WinNT.VER_MAJORVERSION, | ||
| (byte) WinNT.VER_GREATER_EQUAL); | ||
| dwlConditionMask = Kernel32.INSTANCE.VerSetConditionMask(dwlConditionMask, WinNT.VER_MINORVERSION, | ||
| (byte) WinNT.VER_GREATER_EQUAL); | ||
| dwlConditionMask = Kernel32.INSTANCE.VerSetConditionMask(dwlConditionMask, WinNT.VER_SERVICEPACKMAJOR, | ||
| (byte) WinNT.VER_GREATER_EQUAL); | ||
|
|
||
| return Kernel32.INSTANCE.VerifyVersionInfoW(osvi, | ||
| WinNT.VER_MAJORVERSION | WinNT.VER_MINORVERSION | WinNT.VER_SERVICEPACKMAJOR, dwlConditionMask); | ||
| } | ||
|
|
||
| /* | ||
| * The constants Kernel32.WIN32_WINNT_* are 2-byte encodings of windows | ||
| * version numbers, for example Windows XP is version 5.1 and is encoded as | ||
| * 0x0501. To pass to IsWindowsVersionOrGreater, we pass the HIBYTE (e.g., | ||
| * 0x05) as the first argument and LOBYTE (e.g., 0x01) as the second. To get | ||
| * the high byte of a short, we shift right 8 bits and cast to byte, e.g., | ||
| * (byte) (word>>>8); to get the low byte wse simply cast to byte. | ||
| */ | ||
|
|
||
| /** | ||
| * @return true if the current OS version matches, or is greater than, the | ||
| * Windows XP version. | ||
| */ | ||
| public static boolean IsWindowsXPOrGreater() { | ||
|
There was a problem hiding this comment. I'm not sure whether I like this, but I don't see a saner version, that doesn't look like repeats... What might be worth evaluation is, if pulling There was a problem hiding this comment. I did try to faithfully reproduce the existing inline header file, in the interest of readability. I think adding variables would be worse than just explicitly doing the math ( There was a problem hiding this comment. Sorry! I did not realize, that I had looked at an older SDK, that did not contain the header. And I just realized, that you linked the header. Your first version was better readable. There was a problem hiding this comment. So you want me to go back to the HIBYTE and LOBYTE methods (that would be JIT optimized) rather than the current compiler-optimized bit math? I kind of like the current version and think adding a comment would make it just as readable/understandable for future maintainers. There was a problem hiding this comment. My thinking was, that at this time I understand what you are doing there. But in 6-12 months I might have a WTF moment. I'm ok if you want to keep the bit shifts inline. Independend of this - my original idea was this: private static final byte WIN32_WINNT_WINXP_MAJOR = HIBYTE(WinNT.WIN32_WINNT_WINXP);
private static final byte WIN32_WINNT_WINXP_MINOR = LOBYTE(WinNT.WIN32_WINNT_WINXP);
/**
* @return true if the current OS version matches, or is greater than, the
* Windows XP version.
*/
public static boolean IsWindowsXPOrGreater() {
return IsWindowsVersionOrGreater(WIN32_WINNT_WINXP_MAJOR, WIN32_WINNT_WINXP_MINOR, 0);
}Pulling the calculation into a static final. But as said, if you like it this way, I won't stand in the way. There was a problem hiding this comment. I'll add a comment explaining what the bit shifts do, so you and I both can remember what's going on in 6-12 months. |
||
| return IsWindowsVersionOrGreater((byte) (Kernel32.WIN32_WINNT_WINXP >>> 8), (byte) Kernel32.WIN32_WINNT_WINXP, | ||
| 0); | ||
| } | ||
|
|
||
| /** | ||
| * @return true if the current OS version matches, or is greater than, the | ||
| * Windows XP with Service Pack 1 (SP1) version. | ||
| */ | ||
| public static boolean IsWindowsXPSP1OrGreater() { | ||
| return IsWindowsVersionOrGreater((byte) (Kernel32.WIN32_WINNT_WINXP >>> 8), (byte) Kernel32.WIN32_WINNT_WINXP, | ||
| 1); | ||
| } | ||
|
|
||
| /** | ||
| * @return true if the current OS version matches, or is greater than, the | ||
| * Windows XP with Service Pack 2 (SP2) version. | ||
| */ | ||
| public static boolean IsWindowsXPSP2OrGreater() { | ||
| return IsWindowsVersionOrGreater((byte) (Kernel32.WIN32_WINNT_WINXP >>> 8), (byte) Kernel32.WIN32_WINNT_WINXP, | ||
| 2); | ||
| } | ||
|
|
||
| /** | ||
| * @return true if the current OS version matches, or is greater than, the | ||
| * Windows XP with Service Pack 3 (SP3) version. | ||
| */ | ||
| public static boolean IsWindowsXPSP3OrGreater() { | ||
| return IsWindowsVersionOrGreater((byte) (Kernel32.WIN32_WINNT_WINXP >>> 8), (byte) Kernel32.WIN32_WINNT_WINXP, | ||
| 3); | ||
| } | ||
|
|
||
| /** | ||
| * @return true if the current OS version matches, or is greater than, the | ||
| * Windows Vista version. | ||
| */ | ||
| public static boolean IsWindowsVistaOrGreater() { | ||
| return IsWindowsVersionOrGreater((byte) (Kernel32.WIN32_WINNT_VISTA >>> 8), (byte) Kernel32.WIN32_WINNT_VISTA, | ||
| 0); | ||
| } | ||
|
|
||
| /** | ||
| * @return true if the current OS version matches, or is greater than, the | ||
| * Windows Vista with Service Pack 1 (SP1) version. | ||
| */ | ||
| public static boolean IsWindowsVistaSP1OrGreater() { | ||
| return IsWindowsVersionOrGreater((byte) (Kernel32.WIN32_WINNT_VISTA >>> 8), (byte) Kernel32.WIN32_WINNT_VISTA, | ||
| 1); | ||
| } | ||
|
|
||
| /** | ||
| * @return true if the current OS version matches, or is greater than, the | ||
| * Windows Vista with Service Pack 2 (SP2) version. | ||
| */ | ||
| public static boolean IsWindowsVistaSP2OrGreater() { | ||
| return IsWindowsVersionOrGreater((byte) (Kernel32.WIN32_WINNT_VISTA >>> 8), (byte) Kernel32.WIN32_WINNT_VISTA, | ||
| 2); | ||
| } | ||
|
|
||
| /** | ||
| * @return true if the current OS version matches, or is greater than, the | ||
| * Windows 7 version. | ||
| */ | ||
| public static boolean IsWindows7OrGreater() { | ||
| return IsWindowsVersionOrGreater((byte) (Kernel32.WIN32_WINNT_WIN7 >>> 8), (byte) Kernel32.WIN32_WINNT_WIN7, 0); | ||
| } | ||
|
|
||
| /** | ||
| * @return true if the current OS version matches, or is greater than, the | ||
| * Windows 7 with Service Pack 1 (SP1) version. | ||
| */ | ||
| public static boolean IsWindows7SP1OrGreater() { | ||
| return IsWindowsVersionOrGreater((byte) (Kernel32.WIN32_WINNT_WIN7 >>> 8), (byte) Kernel32.WIN32_WINNT_WIN7, 1); | ||
| } | ||
|
|
||
| /** | ||
| * @return true if the current OS version matches, or is greater than, the | ||
| * Windows 8 version. | ||
| */ | ||
| public static boolean IsWindows8OrGreater() { | ||
| return IsWindowsVersionOrGreater((byte) (Kernel32.WIN32_WINNT_WIN8 >>> 8), (byte) Kernel32.WIN32_WINNT_WIN8, 0); | ||
| } | ||
|
|
||
| /** | ||
| * @return true if the current OS version matches, or is greater than, the | ||
| * Windows 8.1 version. For Windows 8.1 and/or Windows 10, | ||
| * {@link #IsWindows8Point1OrGreater} returns false unless the | ||
| * application contains a manifest that includes a compatibility | ||
| * section that contains the GUIDs that designate Windows 8.1 and/or | ||
| * Windows 10. | ||
| */ | ||
| public static boolean IsWindows8Point1OrGreater() { | ||
| return IsWindowsVersionOrGreater((byte) (Kernel32.WIN32_WINNT_WINBLUE >>> 8), | ||
| (byte) Kernel32.WIN32_WINNT_WINBLUE, 0); | ||
| } | ||
|
|
||
| /** | ||
| * @return true if the current OS version matches, or is greater than, the | ||
| * Windows 10 version. For Windows 10, | ||
| * {@link #IsWindows8Point1OrGreater} returns false unless the | ||
| * application contains a manifest that includes a compatibility | ||
| * section that contains the GUID that designates Windows 10. | ||
| */ | ||
| public static boolean IsWindows10OrGreater() { | ||
| return IsWindowsVersionOrGreater((byte) (Kernel32.WIN32_WINNT_WIN10 >>> 8), (byte) Kernel32.WIN32_WINNT_WIN10, | ||
| 0); | ||
| } | ||
|
|
||
| /** | ||
| * Applications that need to distinguish between server and client versions | ||
| * of Windows should call this function. | ||
| * | ||
| * @return true if the current OS is a Windows Server release. | ||
| */ | ||
| public static boolean IsWindowsServer() { | ||
| // This should properly be OSVERSIONINFOEXW which is not defined in JNA. | ||
| // The OSVERSIONINFOEX structure in JNA is the (W) Unicode-compliant | ||
| // version. | ||
| OSVERSIONINFOEX osvi = new OSVERSIONINFOEX(); | ||
| osvi.dwOSVersionInfoSize = new DWORD(osvi.size()); | ||
| osvi.wProductType = WinNT.VER_NT_WORKSTATION; | ||
|
|
||
| long dwlConditionMask = Kernel32.INSTANCE.VerSetConditionMask(0, WinNT.VER_PRODUCT_TYPE, | ||
| (byte) WinNT.VER_EQUAL); | ||
|
|
||
| return !Kernel32.INSTANCE.VerifyVersionInfoW(osvi, WinNT.VER_PRODUCT_TYPE, dwlConditionMask); | ||
| } | ||
| } | ||
|
|
||
This file contains 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
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please update the version behind "Next release" to "5.3.0", as it will be a feature release with this change.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thought so and somewhat expected this comment. :)