OSVERSIONINFOW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||
|---|---|---|---|---|---|---|---|---|---|
| dwOSVersionInfoSize | DWORD | 4 | +0 | +0 | このデータ構造のサイズ (バイト単位)。このメンバーには sizeof(OSVERSIONINFO) を設定します。 | ||||
| dwMajorVersion | DWORD | 4 | +4 | +4 | オペレーティング システムのメジャー バージョン番号。詳細については「解説」を参照してください。 | ||||
| dwMinorVersion | DWORD | 4 | +8 | +8 | オペレーティング システムのマイナー バージョン番号。詳細については「解説」を参照してください。 | ||||
| dwBuildNumber | DWORD | 4 | +12 | +12 | オペレーティング システムのビルド番号。 | ||||
| dwPlatformId | DWORD | 4 | +16 | +16 | オペレーティング システムのプラットフォーム。このメンバーには次の値を指定できます。
| ||||
| szCSDVersion | WCHAR | 256 | +20 | +20 | システムにインストールされている最新の Service Pack を示す、"Service Pack 3" のような null 終端文字列。Service Pack がインストールされていない場合、この文字列は空です。 |
公式ドキュメント
オペレーティング システムのバージョン情報を格納します。この情報には、メジャー バージョン番号とマイナー バージョン番号、ビルド番号、プラットフォーム識別子、およびオペレーティング システムを説明するテキストが含まれます。この構造体は GetVersionEx 関数で使用します。
追加のバージョン情報を取得するには、代わりに OSVERSIONINFOEX 構造体を GetVersionEx と共に使用してください。
解説(Remarks)
バージョン情報に依存することは、機能の有無を調べる最適な方法ではありません。代わりに、目的の機能のドキュメントを参照してください。機能検出の一般的な手法について詳しくは、 Operating System Version を参照してください。
特定のオペレーティング システムを必須とする場合は、1 つのオペレーティング システムだけを対象にテストを設計するのではなく、サポートされる最小バージョンとして扱ってください。こうすることで、検出コードは将来のバージョンの Windows でも動作し続けます。
次の表は、サポートされているバージョンの Windows が返す値をまとめたものです。バージョン番号が同一のオペレーティング システムを区別するには、"その他" と記された列の情報を使用してください。
| オペレーティング システム | バージョン番号 | dwMajorVersion | dwMinorVersion | その他 |
|---|---|---|---|---|
| Windows 10 | 10.0* | 10 | 0 | OSVERSIONINFOEX.wProductType == VER_NT_WORKSTATION |
| Windows Server 2016 | 10.0* | 10 | 0 | OSVERSIONINFOEX.wProductType != VER_NT_WORKSTATION |
| Windows 8.1 | 6.3* | 6 | 3 | OSVERSIONINFOEX.wProductType == VER_NT_WORKSTATION |
| Windows Server 2012 R2 | 6.3* | 6 | 3 | OSVERSIONINFOEX.wProductType != VER_NT_WORKSTATION |
| Windows 8 | 6.2 | 6 | 2 | OSVERSIONINFOEX.wProductType == VER_NT_WORKSTATION |
| Windows Server 2012 | 6.2 | 6 | 2 | OSVERSIONINFOEX.wProductType != VER_NT_WORKSTATION |
| Windows 7 | 6.1 | 6 | 1 | OSVERSIONINFOEX.wProductType == VER_NT_WORKSTATION |
| Windows Server 2008 R2 | 6.1 | 6 | 1 | OSVERSIONINFOEX.wProductType != VER_NT_WORKSTATION |
| Windows Server 2008 | 6.0 | 6 | 0 | OSVERSIONINFOEX.wProductType != VER_NT_WORKSTATION |
| Windows Vista | 6.0 | 6 | 0 | OSVERSIONINFOEX.wProductType == VER_NT_WORKSTATION |
| Windows Server 2003 R2 | 5.2 | 5 | 2 | GetSystemMetrics(SM_SERVERR2) != 0 |
| Windows Server 2003 | 5.2 | 5 | 2 | GetSystemMetrics(SM_SERVERR2) == 0 |
| Windows XP | 5.1 | 5 | 1 | 該当なし |
| Windows 2000 | 5.0 | 5 | 0 | 該当なし |
| * Windows 8.1 または Windows 10 向けにマニフェストが指定されたアプリケーションの場合です。Windows 8.1 または Windows 10 向けにマニフェストが指定されていないアプリケーションでは、Windows 8 の OS バージョン値 (6.2) が返されます。アプリケーションに Windows 8.1 または Windows 10 向けのマニフェストを指定するには、Targeting your application for Windows を参照してください。 | ||||
例
例については、 Getting the System Version を参照してください。
winnt.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして OSVERSIONINFO を定義します。エンコーディングに依存しないエイリアスと、エンコーディングに依存するコードを混在させると、不一致が生じてコンパイル エラーや実行時エラーの原因になることがあります。詳しくは、Conventions for Function Prototypes を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// OSVERSIONINFOW (x64 276 / x86 276 バイト)
typedef struct OSVERSIONINFOW {
DWORD dwOSVersionInfoSize;
DWORD dwMajorVersion;
DWORD dwMinorVersion;
DWORD dwBuildNumber;
DWORD dwPlatformId;
WCHAR szCSDVersion[128];
} OSVERSIONINFOW;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct OSVERSIONINFOW
{
public uint dwOSVersionInfoSize;
public uint dwMajorVersion;
public uint dwMinorVersion;
public uint dwBuildNumber;
public uint dwPlatformId;
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 128)] public string szCSDVersion;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure OSVERSIONINFOW
Public dwOSVersionInfoSize As UInteger
Public dwMajorVersion As UInteger
Public dwMinorVersion As UInteger
Public dwBuildNumber As UInteger
Public dwPlatformId As UInteger
<MarshalAs(UnmanagedType.ByValTStr, SizeConst:=128)> Public szCSDVersion As String
End Structureimport ctypes
from ctypes import wintypes
class OSVERSIONINFOW(ctypes.Structure):
_fields_ = [
("dwOSVersionInfoSize", wintypes.DWORD),
("dwMajorVersion", wintypes.DWORD),
("dwMinorVersion", wintypes.DWORD),
("dwBuildNumber", wintypes.DWORD),
("dwPlatformId", wintypes.DWORD),
("szCSDVersion", ctypes.c_wchar * 128),
]#[repr(C)]
pub struct OSVERSIONINFOW {
pub dwOSVersionInfoSize: u32,
pub dwMajorVersion: u32,
pub dwMinorVersion: u32,
pub dwBuildNumber: u32,
pub dwPlatformId: u32,
pub szCSDVersion: [u16; 128],
}import "golang.org/x/sys/windows"
type OSVERSIONINFOW struct {
dwOSVersionInfoSize uint32
dwMajorVersion uint32
dwMinorVersion uint32
dwBuildNumber uint32
dwPlatformId uint32
szCSDVersion [128]uint16
}type
OSVERSIONINFOW = record
dwOSVersionInfoSize: DWORD;
dwMajorVersion: DWORD;
dwMinorVersion: DWORD;
dwBuildNumber: DWORD;
dwPlatformId: DWORD;
szCSDVersion: array[0..127] of WideChar;
end;const OSVERSIONINFOW = extern struct {
dwOSVersionInfoSize: u32,
dwMajorVersion: u32,
dwMinorVersion: u32,
dwBuildNumber: u32,
dwPlatformId: u32,
szCSDVersion: [128]u16,
};type
OSVERSIONINFOW {.bycopy.} = object
dwOSVersionInfoSize: uint32
dwMajorVersion: uint32
dwMinorVersion: uint32
dwBuildNumber: uint32
dwPlatformId: uint32
szCSDVersion: array[128, uint16]struct OSVERSIONINFOW
{
uint dwOSVersionInfoSize;
uint dwMajorVersion;
uint dwMinorVersion;
uint dwBuildNumber;
uint dwPlatformId;
wchar[128] szCSDVersion;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; OSVERSIONINFOW サイズ: 276 バイト(x64)
dim st, 69 ; 4byte整数×69(構造体サイズ 276 / 4 切り上げ)
; dwOSVersionInfoSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwMajorVersion : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; dwMinorVersion : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwBuildNumber : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; dwPlatformId : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; szCSDVersion : WCHAR (+20, 256byte) varptr(st)+20 を基点に操作(256byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global OSVERSIONINFOW
#field int dwOSVersionInfoSize
#field int dwMajorVersion
#field int dwMinorVersion
#field int dwBuildNumber
#field int dwPlatformId
#field wchar szCSDVersion 128
#endstruct
stdim st, OSVERSIONINFOW ; NSTRUCT 変数を確保
st->dwOSVersionInfoSize = 100
mes "dwOSVersionInfoSize=" + st->dwOSVersionInfoSize