낚시하는 개발자

(혹은 GetVersion 함수)를 사용하려고 하니 아래와 같은 오류를 내뱉으며 컴파일이 되질 않습니다.

물론 #pragma warning(disable:4996) 으로 에러가 발생하지 않게 막아놓고 사용할수야 있겠지만 이렇게 사용하기에는 찝찝한 기분을 떨쳐버릴 수가 없습니다. MS가 GetVersionEx 함수를 deprecated 시키고 컴파일 오류까지 발생시키며 사용하지 말 것을 권장한다면, 거기에는 분명히 그럴만한 이유가 있겠죠. 그렇다면 왜 지금까지 잘 사용해오던 GetVersionEx 함수를 이제와서 사용하지 말라고 하는걸까요?

호환 모드 문제

윈도우에서는 다음과 같이 어플리케이션을 호환 모드로 실행할 수 있게 되어있습니다.

어플리케이션을 호환 모드로 실행하였을 경우에 GetVersionEx 함수를 사용하면 현재 윈도우 버전을 얻어오는 것이 아니라 호환 모드에서 선택한 윈도우 버전을 얻어오게 됩니다. 실제로 윈도우 8에서 호환 모드를 Windows XP SP3로 설정하고 실행하니 다음과 같이 GetVersionEx 함수가 Windows XP SP3 버전(5.1.3)을 리턴하는 것을 볼 수 있습니다.

 

GetVersionEx 함수의 호환 모드 문제는 사실 어제 오늘의 문제가 아니라 지금까지 쭈욱 발생되어왔던 문제입니다. 일반적인 상황에서는 호환 모드를 사용할 일이 거의 없기 때문에 신경쓰지 않았을 뿐이죠. 하지만 만에 하나라도 사용자가 호환 모드를 사용한다면 GetVersionEx 함수의 결과값이 달라져서 예기치 못한 문제가 발생할 수 있습니다.

Windows 8.1 문제

GetVersionEx 함수는 앞서 살펴본 호환 모드 문제 뿐만 아니라 또 하나의 중대한 문제점을 가지고 있습니다. 바로 Windows 8.1 이상의 OS에서 제대로 동작하지 않는다는 것인데요, GetVersionEx 함수가 deprecated 된 이유도 이 때문이라 할 수 있습니다. 실제로 Windows 8.1 환경에서 테스트해보니 GetVersionEx 함수가 6.3.0을 리턴하는 대신 Windows 8의 버전인 6.2.0을 리턴하는 것을 볼 수 있습니다.

 

 

• ​Targeting your application for Windows 8.1

Version Helper API

MS에서 GetVersionEx 함수 대신 사용하도록 권장하는 방법은 VerifyVersionInfo 함수 또는 Version Helper API를 사용하는 것입니다. 두 가지 방식 모두 호환 모드 설정에 영향을 받지 않으며, Windows 8.1 이상에서도 문제없이 동작합니다. 

먼저 VerifyVersionInfo 함수는 현재 윈도우 버전이 지정한 버전과 같은지, 같거나 큰지, 작은지 등등을 판단하여 그에 대한 결과를 BOOL 타입으로 리턴하는 함수입니다. VerifyVersionInfo 함수를 이용하여 현재 윈도우 버전이 Windows 8 이상인지 검사하려면 다음과 같이 구현하면 됩니다. 

OSVERSIONINFOEX osvi;
DWORDLONG dwlConditionMask = 0;

ZeroMemory(&osvi, sizeof(OSVERSIONINFOEX));
osvi.dwOSVersionInfoSize = sizeof(OSVERSIONINFOEX);
osvi.dwMajorVersion = 6;
osvi.dwMinorVersion = 2;

VER_SET_CONDITION(dwlConditionMask, VER_MAJORVERSION, VER_GREATER_EQUAL);
VER_SET_CONDITION(dwlConditionMask, VER_MINORVERSION, VER_GREATER_EQUAL);

if (!VerifyVersionInfo(&osvi, VER_MAJORVERSION | VER_MINORVERSION, dwlConditionMask))
{
    ::MessageBox(NULL, _T("You need at least Windows 8"), _T("Version Not Supported"), MB_OK);
}

다음으로 Version Helper API는 Windows 8.1 SDK에 포함되어 있으며(Visual Studio 2012 이하 버전에서는 별도로 설치 필요), 현재까지 지원되는 Version Helper API의 목록은 다음과 같습니다.

• ​IsWindowsXPOrGreater, IsWindowsXPSP1OrGreater, IsWindowsXPSP2OrGreater, IsWindowsXPSP3OrGreater

• IsWindowsVistaOrGreater, IsWindowsVistaSP1OrGreater, IsWindowsVistaSP2OrGreater

• IsWindows7OrGreater, IsWindows7SP1OrGreater

• IsWindows8OrGreater, IsWindows8Point1OrGreater

• IsWindowsServer

• IsWindowsVersionOrGreater

Version Helper API를 이용하여 현재 윈도우 버전이 Windows 8 이상인지 검사하려면 다음과 같이 구현하면 됩니다.

#include <VersionHelpers.h>

if (!IsWindows8OrGreater())
{
    MessageBox(NULL, _T("You need at least Windows 8"), _T("Version Not Supported"), MB_OK);
}

NetWkstaGetInfo 함수는 원래 네트워크상의 워크스테이션 정보를 얻어오는 함수지만 윈도우 버전 정보을 얻어오는 데에도 활용할 수 있습니다). 개인적으로는 두 번째 방법이 더 깔끔한 것 같아서 두 번째 방법으로 GetWindowsVersion 함수를 구현해봤습니다.

#include <Lm.h>
#pragma comment(lib, "netapi32.lib")

BOOL GetWindowsVersion(DWORD& dwMajor, DWORD& dwMinor)
{
    static DWORD dwMajorCache = 0, dwMinorCache = 0;
    if (0 != dwMajorCache)
    {
        dwMajor = dwMajorCache;
        dwMinor = dwMinorCache;
        return TRUE;
    }

    LPWKSTA_INFO_100 pBuf = NULL;
    if (NERR_Success != NetWkstaGetInfo(NULL, 100, (LPBYTE*)&pBuf))
        return FALSE;

    dwMajor = dwMajorCache = pBuf->wki100_ver_major;
    dwMinor = dwMinorCache = pBuf->wki100_ver_minor;
    NetApiBufferFree(pBuf);

    return TRUE;
}

NetWkstaGetInfo 함수를 호출하고, 그 다음부터는 캐시 값을 리턴하도록 구현했습니다. 그리고 NetWkstaGetInfo 함수로는 서비스팩 버전을 구할 수 없으므로 기존 GetWindowsVersion 함수와 

BOOL GetWindowsVersion(DWORD& dwMajor, DWORD& dwMinor, DWORD& dwServicePack)
{
    if (!GetWindowsVersion(dwMajor, dwMinor))
        return FALSE;

    static DWORD dwServicePackCache = ULONG_MAX;
    if (ULONG_MAX != dwServicePackCache)
    {
        dwServicePack = dwServicePackCache;
        return TRUE;
    }

    const int nServicePackMax = 10;
    OSVERSIONINFOEX osvi;
    DWORDLONG dwlConditionMask = 0;

    ZeroMemory(&osvi, sizeof(OSVERSIONINFOEX));
    osvi.dwOSVersionInfoSize = sizeof(OSVERSIONINFOEX);
    VER_SET_CONDITION(dwlConditionMask, VER_SERVICEPACKMAJOR, VER_EQUAL);

    for (int i = 0; i < nServicePackMax; ++i)
    {
        osvi.wServicePackMajor = i;
        if (VerifyVersionInfo(&osvi, VER_SERVICEPACKMAJOR, dwlConditionMask))
        {
            dwServicePack = dwServicePackCache = i;
            return TRUE;
        }
    }
    return FALSE;
}

Part1: Overcoming Windows 8.1's deprecation of GetVersionEx and GetVersion APIs

원문 링크