Win32 API 日本語リファレンス
ホーム › Networking.Clustering › CLUSTERVERSIONINFO

CLUSTERVERSIONINFO

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 284 バイト / x86: 284 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド型サイズx64x86説明
dwVersionInfoSizeDWORD4+0+0データ構造のサイズ (バイト単位)。GetClusterInformation を呼び出す前に、このサイズを設定する必要があります。
MajorVersionWORD2+4+4ローカル ノードにインストールされているオペレーティング システムのメジャー バージョン番号を示します。たとえば、バージョン X.Y の場合、メジャー バージョン番号は X です。
MinorVersionWORD2+6+6ローカル ノードにインストールされているオペレーティング システムのマイナー バージョン番号を示します。たとえば、バージョン X.Y の場合、マイナー バージョン番号は Y です。
BuildNumberWORD2+8+8ローカル ノードにインストールされているオペレーティング システムのビルド番号 (224 など) を示します。
szVendorIdWCHAR128+10+10ローカル ノードにインストールされているクラスター サービスのベンダー識別情報を格納します。
szCSDVersionWCHAR128+138+138ノードにインストールされている最新のサービス パックを格納します。サービス パックがインストールされていない場合、szCSDVersion メンバーは空です。
dwClusterHighestVersionDWORD4+268+268ローカル ノードにインストールされているクラスター サービスが、結合してクラスターを構成できる相手のクラスター サービスの最上位バージョンを示します。
dwClusterLowestVersionDWORD4+272+272ローカル ノードにインストールされているクラスター サービスが、結合してクラスターを構成できる相手のクラスター サービスの最下位バージョンを示します。
dwFlagsDWORD4+276+276クラスター ノードが異なるバージョンのクラスター サービスを実行している場合、この値は CLUSTER_VERSION_FLAG_MIXED_MODE に設定されます。すべてのクラスター ノードが同じバージョンのクラスター サービスを実行している場合、この値は 0 です。
dwReservedDWORD4+280+280この値は内部使用のために予約されています。

公式ドキュメント

ノードにローカルにインストールされているクラスター サービスのバージョンに関する情報を示します。

解説(Remarks)

クラスターのバージョン情報を取得するには、アプリケーションで CLUSTERVERSIONINFO 構造体を宣言し、dwVersionInfoSize メンバーに構造体のサイズを指定して、GetClusterInformation 関数を呼び出します。GetClusterInformation が構造体のメンバー データを設定します。

バージョン情報のあらゆる組み合わせで上書きが発生しないようにするため、dwVersionInfoSize には常に次の値を設定してください。

sizeof(CLUSTERVERSIONINFO)

dwClusterHighestVersion と dwClusterLowestVersion の値は、ローカル ノードが他のノードと結合してクラスターを構成できるかどうかを示します。次のいずれかに該当する場合、結合は成功する可能性があります。

クラスター サービスがバージョン番号を作成して使用する方法の詳細については、Version Compatibility を参照してください。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// CLUSTERVERSIONINFO  (x64 284 / x86 284 バイト)
typedef struct CLUSTERVERSIONINFO {
    DWORD dwVersionInfoSize;
    WORD MajorVersion;
    WORD MinorVersion;
    WORD BuildNumber;
    WCHAR szVendorId[64];
    WCHAR szCSDVersion[64];
    DWORD dwClusterHighestVersion;
    DWORD dwClusterLowestVersion;
    DWORD dwFlags;
    DWORD dwReserved;
} CLUSTERVERSIONINFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CLUSTERVERSIONINFO
{
    public uint dwVersionInfoSize;
    public ushort MajorVersion;
    public ushort MinorVersion;
    public ushort BuildNumber;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 64)] public string szVendorId;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 64)] public string szCSDVersion;
    public uint dwClusterHighestVersion;
    public uint dwClusterLowestVersion;
    public uint dwFlags;
    public uint dwReserved;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CLUSTERVERSIONINFO
    Public dwVersionInfoSize As UInteger
    Public MajorVersion As UShort
    Public MinorVersion As UShort
    Public BuildNumber As UShort
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=64)> Public szVendorId As String
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=64)> Public szCSDVersion As String
    Public dwClusterHighestVersion As UInteger
    Public dwClusterLowestVersion As UInteger
    Public dwFlags As UInteger
    Public dwReserved As UInteger
End Structure
import ctypes
from ctypes import wintypes

class CLUSTERVERSIONINFO(ctypes.Structure):
    _fields_ = [
        ("dwVersionInfoSize", wintypes.DWORD),
        ("MajorVersion", ctypes.c_ushort),
        ("MinorVersion", ctypes.c_ushort),
        ("BuildNumber", ctypes.c_ushort),
        ("szVendorId", ctypes.c_wchar * 64),
        ("szCSDVersion", ctypes.c_wchar * 64),
        ("dwClusterHighestVersion", wintypes.DWORD),
        ("dwClusterLowestVersion", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("dwReserved", wintypes.DWORD),
    ]
#[repr(C)]
pub struct CLUSTERVERSIONINFO {
    pub dwVersionInfoSize: u32,
    pub MajorVersion: u16,
    pub MinorVersion: u16,
    pub BuildNumber: u16,
    pub szVendorId: [u16; 64],
    pub szCSDVersion: [u16; 64],
    pub dwClusterHighestVersion: u32,
    pub dwClusterLowestVersion: u32,
    pub dwFlags: u32,
    pub dwReserved: u32,
}
import "golang.org/x/sys/windows"

type CLUSTERVERSIONINFO struct {
	dwVersionInfoSize uint32
	MajorVersion uint16
	MinorVersion uint16
	BuildNumber uint16
	szVendorId [64]uint16
	szCSDVersion [64]uint16
	dwClusterHighestVersion uint32
	dwClusterLowestVersion uint32
	dwFlags uint32
	dwReserved uint32
}
type
  CLUSTERVERSIONINFO = record
    dwVersionInfoSize: DWORD;
    MajorVersion: Word;
    MinorVersion: Word;
    BuildNumber: Word;
    szVendorId: array[0..63] of WideChar;
    szCSDVersion: array[0..63] of WideChar;
    dwClusterHighestVersion: DWORD;
    dwClusterLowestVersion: DWORD;
    dwFlags: DWORD;
    dwReserved: DWORD;
  end;
const CLUSTERVERSIONINFO = extern struct {
    dwVersionInfoSize: u32,
    MajorVersion: u16,
    MinorVersion: u16,
    BuildNumber: u16,
    szVendorId: [64]u16,
    szCSDVersion: [64]u16,
    dwClusterHighestVersion: u32,
    dwClusterLowestVersion: u32,
    dwFlags: u32,
    dwReserved: u32,
};
type
  CLUSTERVERSIONINFO {.bycopy.} = object
    dwVersionInfoSize: uint32
    MajorVersion: uint16
    MinorVersion: uint16
    BuildNumber: uint16
    szVendorId: array[64, uint16]
    szCSDVersion: array[64, uint16]
    dwClusterHighestVersion: uint32
    dwClusterLowestVersion: uint32
    dwFlags: uint32
    dwReserved: uint32
struct CLUSTERVERSIONINFO
{
    uint dwVersionInfoSize;
    ushort MajorVersion;
    ushort MinorVersion;
    ushort BuildNumber;
    wchar[64] szVendorId;
    wchar[64] szCSDVersion;
    uint dwClusterHighestVersion;
    uint dwClusterLowestVersion;
    uint dwFlags;
    uint dwReserved;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CLUSTERVERSIONINFO サイズ: 284 バイト(x64)
dim st, 71    ; 4byte整数×71(構造体サイズ 284 / 4 切り上げ)
; dwVersionInfoSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; MajorVersion : WORD (+4, 2byte)  wpoke st,4,値  /  値 = wpeek(st,4)
; MinorVersion : WORD (+6, 2byte)  wpoke st,6,値  /  値 = wpeek(st,6)
; BuildNumber : WORD (+8, 2byte)  wpoke st,8,値  /  値 = wpeek(st,8)
; szVendorId : WCHAR (+10, 128byte)  varptr(st)+10 を基点に操作(128byte:入れ子/配列)
; szCSDVersion : WCHAR (+138, 128byte)  varptr(st)+138 を基点に操作(128byte:入れ子/配列)
; dwClusterHighestVersion : DWORD (+268, 4byte)  st.67 = 値  /  値 = st.67   (lpoke/lpeek も可)
; dwClusterLowestVersion : DWORD (+272, 4byte)  st.68 = 値  /  値 = st.68   (lpoke/lpeek も可)
; dwFlags : DWORD (+276, 4byte)  st.69 = 値  /  値 = st.69   (lpoke/lpeek も可)
; dwReserved : DWORD (+280, 4byte)  st.70 = 値  /  値 = st.70   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CLUSTERVERSIONINFO
    #field int dwVersionInfoSize
    #field short MajorVersion
    #field short MinorVersion
    #field short BuildNumber
    #field wchar szVendorId 64
    #field wchar szCSDVersion 64
    #field int dwClusterHighestVersion
    #field int dwClusterLowestVersion
    #field int dwFlags
    #field int dwReserved
#endstruct

stdim st, CLUSTERVERSIONINFO        ; NSTRUCT 変数を確保
st->dwVersionInfoSize = 100
mes "dwVersionInfoSize=" + st->dwVersionInfoSize