버전 도우미 함수

  • 아티클

다음 함수를 사용하여 현재 운영 체제 버전을 확인하거나 Windows 또는 Windows Server 릴리스인지 식별할 수 있습니다. 이러한 함수는 VerifyVersionInfo 함수를 사용하는 간단한 테스트와 운영 체제 버전을 결정하는 강력한 수단으로 입증된 비교보다 크거나 같은 권장 사항을 제공합니다.

참고

이러한 API는 Windows 8.1 SDK(소프트웨어 개발 키트)에 포함된 versionhelpers.h에 의해 정의됩니다. 이 파일은 다른 Microsoft Visual Studio 릴리스와 함께 사용하여 Windows 8.1 전에 Windows 버전에 대해 동일한 기능을 구현할 수 있습니다.

함수 Description
IsWindowsXPOrGreater 현재 OS 버전이 Windows XP 버전과 일치하거나 그보다 큰지 여부를 나타냅니다.
IsWindowsXPSP1OrGreater 현재 OS 버전이 WINDOWS XP SP1(서비스 팩 1) 버전과 일치하거나 그보다 큰지 여부를 나타냅니다.
IsWindowsXPSP2OrGreater 현재 OS 버전이 WINDOWS XP SP2(서비스 팩 2) 버전과 일치하거나 그보다 큰지 여부를 나타냅니다.
IsWindowsXPSP3OrGreater 현재 OS 버전이 WINDOWS XP SP3(서비스 팩 3) 버전과 일치하거나 그보다 큰지 여부를 나타냅니다.
IsWindowsVistaOrGreater 현재 OS 버전이 Windows Vista 버전과 일치하거나 보다 큰지 여부를 나타냅니다.
IsWindowsVistaSP1OrGreater 현재 OS 버전이 WINDOWS Vista SP1(서비스 팩 1) 버전과 일치하거나 그보다 큰지 여부를 나타냅니다.
IsWindowsVistaSP2OrGreater 현재 OS 버전이 WINDOWS Vista SP2(서비스 팩 2) 버전과 일치하거나 보다 큰지 여부를 나타냅니다.
IsWindows7OrGreater 현재 OS 버전이 Windows 7 버전과 일치하거나 그보다 큰지 여부를 나타냅니다.
IsWindows7SP1OrGreater 현재 OS 버전이 WINDOWS 7 SP1(서비스 팩 1) 버전과 일치하거나 그보다 큰지 여부를 나타냅니다.
IsWindows8OrGreater 현재 OS 버전이 Windows 8 버전과 일치하거나 보다 큰지 여부를 나타냅니다.
IsWindows8Point1OrGreater 현재 OS 버전이 Windows 8.1 버전과 일치하거나 보다 큰지 여부를 나타냅니다.
Windows 10 경우 애플리케이션에 Windows 8.1 및/또는 Windows 10 지정하는 GUID가 포함된 호환성 섹션이 포함된 매니페스트가 포함되어 있지 않으면 IsWindows8Point1OrGreater는 false를 반환합니다.
IsWindows10OrGreater 현재 OS 버전이 Windows 10 버전과 일치하거나 보다 큰지 여부를 나타냅니다.
Windows 10 경우 애플리케이션에 Windows 10 지정하는 GUID가 포함된 호환성 섹션이 포함된 매니페스트가 포함되어 있지 않으면 IsWindows10OrGreater는 false를 반환합니다.
IsWindowsServer 현재 OS가 Windows Server 릴리스인지를 나타냅니다. 서버 버전과 클라이언트 버전의 Windows를 구분해야 하는 애플리케이션은 이 함수를 호출해야 합니다.
IsWindowsVersionOrGreater 제공된 다른 버전 도우미 함수가 시나리오에 맞지 않는 경우에만 이 함수를 사용해야 합니다.
현재 OS 버전이 제공된 버전 정보와 일치하거나 보다 큰지 여부를 나타냅니다. 이 함수는 클라이언트 릴리스와 버전 번호를 공유하지 않는 Windows Server 버전을 확인하는 데 유용합니다.

예제

VersionHelpers.h 헤더 파일에 정의된 인라인 함수를 사용하면 Windows 버전을 테스트할 때 부울 값을 반환하여 운영 체제 버전을 확인할 수 있습니다.

예를 들어 애플리케이션에 Windows 8 이상이 필요한 경우 다음 테스트를 사용합니다.

#include <VersionHelpers.h>
 
if (!IsWindows8OrGreater())
{
   MessageBox(NULL, "You need at least Windows 8", "Version Not Supported", MB_OK);
}