GetVersionEx

원형

BOOL GetVersionEx(LPOSVERSIONINFO lpVersionInfo);

MFC 원형

해당하는 함수 없음

인수

▶lpVersionInfo : 운영체제 버전을 리턴받기 위한 구조체이다.

typedef struct _OSVERSIONINFO{ 
  DWORD dwOSVersionInfoSize; 
  DWORD dwMajorVersion; 
  DWORD dwMinorVersion; 
  DWORD dwBuildNumber; 
  DWORD dwPlatformId; 
  TCHAR szCSDVersion[ 128 ]; 
} OSVERSIONINFO;

첫번째 멤버는 이 구조체의 크기이며 두번째, 세번째 버전은 운영체제의 버전에 대한 정수부와 실수부이다. 각 운영체제의 버전은 다음과 같다.

운영체제 버전

98

4.0
98 4.10
ME 4.90
NT 3.51 3.51
NT 4.0 4.0
2000 5.0
XP 5.1

dwBuildBumber는 운영체제의 빌드 넘버, 즉 컴파일한 회수를 나타낸다. dwPlatformId는 운영체제의 종류를 나타내는데 95/98계열는 VER_PLATFORM_WIN32_WINDOWS 이며 NT/200 계열은 VER_PLATFORM_WIN32_NT로 정의된다. 이 값은 기능의 유무를 판단하는 가장 중요한 정보로 사용된다. szCSDVersion은 운영체제에 설치된 서비스 팩, 옵션 팩 등의 정보를 가지는 문자열이다.

리턴

성공하면 0이 아닌 값을 리턴하며 실패시 0을 리턴한다.

설명

운영체제의 버전을 조사한다. 각 운영체제별로 상이하거나 또른 약간씩 다른 방법을 사용해야 한다면 이 함수로 운영체제의 버전을 알아본 후 적절한 방법을 선택적으로 사용할 수 있다. 운영체제 버전에 따라서는 기능이 없는 경우도 있고 사용할 수 없는 API 함수도 있을 수 있으므로 API 함수의 플랫폼 정보를 참조하여 항상 버전에 맞는 함수를 사용하도록 해야 한다.

그러나 특정 기능의 존재 여부를 판단하기 위해 전적으로 이 함수의 결과만을 참조해서는 안된다. 공통 컨트롤, 쉘 API 등의 재배포 가능한 DLL들은 운영체제의 버전과 상관없이 배포된 DLL의 버전에 따라 기능이 달라지며 설치한 프로그램의 목록에 따라 기능이 달라지는 경우도 있으므로 특정 기능의 가능 여부를 판단하기 위해서는 운영체제 버전외에되 DLL의 버전, 설치 프로그램 환경 등도 같이 점검해 볼 필요가 있다.

예제 1

다음 예제는 운영체제의 버전을 조사하여 화면으로 출력해준다.

LRESULT CALLBACK WndProc(HWND hWnd,UINT iMessage,WPARAM wParam,LPARAM lParam)
{
	HDC hdc;
	PAINTSTRUCT ps;
	OSVERSIONINFOEX osv;
	char str[256];

	switch(iMessage) {
	case WM_PAINT:
		hdc=BeginPaint(hWnd, &ps);
		osv.dwOSVersionInfoSize=sizeof(OSVERSIONINFOEX);
		GetVersionEx((LPOSVERSIONINFO)&osv);
		wsprintf(str,"운영체제 버전 = %d.%d, 빌더 넘버=%d",
			osv.dwMajorVersion, osv.dwMinorVersion, osv.dwBuildNumber);
		TextOut(hdc,10,10,str,lstrlen(str));
		EndPaint(hWnd, &ps);
		return 0;
	case WM_DESTROY:
		PostQuitMessage(0);
		return 0;
	}
	return(DefWindowProc(hWnd,iMessage,wParam,lParam));
}

예제를 실행하는 환경에 따라 결과는 달라진다.

참고함수

VerifyVersionInfo

플랫폼

95이상

참조

 


written by http://www.winapi.co.kr