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

CLUSTER_GROUP_ENUM_ITEM

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

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

フィールド

フィールド型サイズx64x86説明
dwVersionDWORD4+0+0
  <b>CLUSTER_GROUP_ENUM_ITEM</b> 構造体のバージョンです。
cbIdDWORD4+4+4lpszId フィールドのサイズ (バイト単位) です。
lpszIdLPWSTR8/4+8+8クラスターグループの ID です。
cbNameDWORD4+16+12IpszName フィールドのサイズ (バイト単位) です。
lpszNameLPWSTR8/4+24+16クラスターグループの名前です。
stateCLUSTER_GROUP_STATE4+32+20クラスターグループの現在の状態です。
cbOwnerNodeDWORD4+36+24IpszOwnerNode フィールドのサイズ (バイト単位) です。
lpszOwnerNodeLPWSTR8/4+40+28グループをホストしているクラスターノードの名前です。
dwFlagsDWORD4+48+32グループのフラグです。
cbPropertiesDWORD4+52+36pProperties フィールドのサイズ (バイト単位) です。
pPropertiesvoid*8/4+56+40共通プロパティの名前の一覧へのポインターです。
cbRoPropertiesDWORD4+64+44pRoProperties フィールドのサイズ (バイト単位) です。
pRoPropertiesvoid*8/4+72+48読み取り専用の共通プロパティの名前の一覧へのポインターです。

公式ドキュメント

クラスターグループのプロパティを格納します。この構造体は、 ClusterGroupEnumEx 関数でクラスターグループを列挙するために使用されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// CLUSTER_GROUP_ENUM_ITEM  (x64 80 / x86 52 バイト)
typedef struct CLUSTER_GROUP_ENUM_ITEM {
    DWORD dwVersion;
    DWORD cbId;
    LPWSTR lpszId;
    DWORD cbName;
    LPWSTR lpszName;
    CLUSTER_GROUP_STATE state;
    DWORD cbOwnerNode;
    LPWSTR lpszOwnerNode;
    DWORD dwFlags;
    DWORD cbProperties;
    void* pProperties;
    DWORD cbRoProperties;
    void* pRoProperties;
} CLUSTER_GROUP_ENUM_ITEM;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CLUSTER_GROUP_ENUM_ITEM
{
    public uint dwVersion;
    public uint cbId;
    public IntPtr lpszId;
    public uint cbName;
    public IntPtr lpszName;
    public int state;
    public uint cbOwnerNode;
    public IntPtr lpszOwnerNode;
    public uint dwFlags;
    public uint cbProperties;
    public IntPtr pProperties;
    public uint cbRoProperties;
    public IntPtr pRoProperties;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CLUSTER_GROUP_ENUM_ITEM
    Public dwVersion As UInteger
    Public cbId As UInteger
    Public lpszId As IntPtr
    Public cbName As UInteger
    Public lpszName As IntPtr
    Public state As Integer
    Public cbOwnerNode As UInteger
    Public lpszOwnerNode As IntPtr
    Public dwFlags As UInteger
    Public cbProperties As UInteger
    Public pProperties As IntPtr
    Public cbRoProperties As UInteger
    Public pRoProperties As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class CLUSTER_GROUP_ENUM_ITEM(ctypes.Structure):
    _fields_ = [
        ("dwVersion", wintypes.DWORD),
        ("cbId", wintypes.DWORD),
        ("lpszId", ctypes.c_void_p),
        ("cbName", wintypes.DWORD),
        ("lpszName", ctypes.c_void_p),
        ("state", ctypes.c_int),
        ("cbOwnerNode", wintypes.DWORD),
        ("lpszOwnerNode", ctypes.c_void_p),
        ("dwFlags", wintypes.DWORD),
        ("cbProperties", wintypes.DWORD),
        ("pProperties", ctypes.c_void_p),
        ("cbRoProperties", wintypes.DWORD),
        ("pRoProperties", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct CLUSTER_GROUP_ENUM_ITEM {
    pub dwVersion: u32,
    pub cbId: u32,
    pub lpszId: *mut core::ffi::c_void,
    pub cbName: u32,
    pub lpszName: *mut core::ffi::c_void,
    pub state: i32,
    pub cbOwnerNode: u32,
    pub lpszOwnerNode: *mut core::ffi::c_void,
    pub dwFlags: u32,
    pub cbProperties: u32,
    pub pProperties: *mut core::ffi::c_void,
    pub cbRoProperties: u32,
    pub pRoProperties: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type CLUSTER_GROUP_ENUM_ITEM struct {
	dwVersion uint32
	cbId uint32
	lpszId uintptr
	cbName uint32
	lpszName uintptr
	state int32
	cbOwnerNode uint32
	lpszOwnerNode uintptr
	dwFlags uint32
	cbProperties uint32
	pProperties uintptr
	cbRoProperties uint32
	pRoProperties uintptr
}
type
  CLUSTER_GROUP_ENUM_ITEM = record
    dwVersion: DWORD;
    cbId: DWORD;
    lpszId: Pointer;
    cbName: DWORD;
    lpszName: Pointer;
    state: Integer;
    cbOwnerNode: DWORD;
    lpszOwnerNode: Pointer;
    dwFlags: DWORD;
    cbProperties: DWORD;
    pProperties: Pointer;
    cbRoProperties: DWORD;
    pRoProperties: Pointer;
  end;
const CLUSTER_GROUP_ENUM_ITEM = extern struct {
    dwVersion: u32,
    cbId: u32,
    lpszId: ?*anyopaque,
    cbName: u32,
    lpszName: ?*anyopaque,
    state: i32,
    cbOwnerNode: u32,
    lpszOwnerNode: ?*anyopaque,
    dwFlags: u32,
    cbProperties: u32,
    pProperties: ?*anyopaque,
    cbRoProperties: u32,
    pRoProperties: ?*anyopaque,
};
type
  CLUSTER_GROUP_ENUM_ITEM {.bycopy.} = object
    dwVersion: uint32
    cbId: uint32
    lpszId: pointer
    cbName: uint32
    lpszName: pointer
    state: int32
    cbOwnerNode: uint32
    lpszOwnerNode: pointer
    dwFlags: uint32
    cbProperties: uint32
    pProperties: pointer
    cbRoProperties: uint32
    pRoProperties: pointer
struct CLUSTER_GROUP_ENUM_ITEM
{
    uint dwVersion;
    uint cbId;
    void* lpszId;
    uint cbName;
    void* lpszName;
    int state;
    uint cbOwnerNode;
    void* lpszOwnerNode;
    uint dwFlags;
    uint cbProperties;
    void* pProperties;
    uint cbRoProperties;
    void* pRoProperties;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CLUSTER_GROUP_ENUM_ITEM サイズ: 52 バイト(x86)
dim st, 13    ; 4byte整数×13(構造体サイズ 52 / 4 切り上げ)
; dwVersion : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; cbId : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; lpszId : LPWSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; cbName : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; lpszName : LPWSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; state : CLUSTER_GROUP_STATE (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; cbOwnerNode : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; lpszOwnerNode : LPWSTR (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; dwFlags : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; cbProperties : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; pProperties : void* (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; cbRoProperties : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; pRoProperties : void* (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CLUSTER_GROUP_ENUM_ITEM サイズ: 80 バイト(x64)
dim st, 20    ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; dwVersion : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; cbId : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; lpszId : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; cbName : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; lpszName : LPWSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; state : CLUSTER_GROUP_STATE (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; cbOwnerNode : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; lpszOwnerNode : LPWSTR (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; dwFlags : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; cbProperties : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; pProperties : void* (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; cbRoProperties : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; pRoProperties : void* (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CLUSTER_GROUP_ENUM_ITEM
    #field int dwVersion
    #field int cbId
    #field intptr lpszId
    #field int cbName
    #field intptr lpszName
    #field int state
    #field int cbOwnerNode
    #field intptr lpszOwnerNode
    #field int dwFlags
    #field int cbProperties
    #field intptr pProperties
    #field int cbRoProperties
    #field intptr pRoProperties
#endstruct

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