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

CLUSPROP_ULARGE_INTEGER

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

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

フィールド

フィールド型サイズx64x86説明
BaseCLUSPROP_VALUE8+0+0プロパティ値ヘッダー。構文と値サイズを保持するCLUSPROP_VALUE構造体である。
liULONGLONG8+8+8符号なしの大きな整数値です。

公式ドキュメント

符号なしの大きな整数 (large integer) を表します。この構造体は 値リストのエントリとして使用され、次の要素で構成されます。

解説(Remarks)

値リスト、プロパティ リスト、 パラメーター ブロックのように DWORD 境界に整列された構造体で大きな整数値を参照する場合は注意してください。Itanium ベース システム用の Windows Server では、 自然境界に整列された大きな整数値は常に 0h または 8h で終わるアドレスから始まります。 DWORD 整列により、大きな値が整列されていない境界 (4h または Ch で終わるアドレス) から始まることがあり、 その場合はデータの読み取りまたは書き込み時に整列違反 (アラインメント フォールト) が発生します。 大きな値の上位および下位の DWORD 部分をそれぞれ個別にローカル変数へコピーすれば、整列違反を回避できます。 ローカル変数は自然境界に整列されることが保証されています。

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

各言語での定義

#include <windows.h>

// CLUSPROP_SYNTAX  (x64 4 / x86 4 バイト)
typedef struct CLUSPROP_SYNTAX {
    DWORD dw;
    _Anonymous_e__Struct Anonymous;
} CLUSPROP_SYNTAX;

// CLUSPROP_VALUE  (x64 8 / x86 8 バイト)
typedef struct CLUSPROP_VALUE {
    CLUSPROP_SYNTAX Syntax;
    DWORD cbLength;
} CLUSPROP_VALUE;

// CLUSPROP_ULARGE_INTEGER  (x64 16 / x86 16 バイト)
typedef struct CLUSPROP_ULARGE_INTEGER {
    CLUSPROP_VALUE Base;
    ULONGLONG li;
} CLUSPROP_ULARGE_INTEGER;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CLUSPROP_SYNTAX
{
    public uint dw;
    public _Anonymous_e__Struct Anonymous;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CLUSPROP_VALUE
{
    public CLUSPROP_SYNTAX Syntax;
    public uint cbLength;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CLUSPROP_ULARGE_INTEGER
{
    public CLUSPROP_VALUE Base;
    public ulong li;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CLUSPROP_SYNTAX
    Public dw As UInteger
    Public Anonymous As _Anonymous_e__Struct
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CLUSPROP_VALUE
    Public Syntax As CLUSPROP_SYNTAX
    Public cbLength As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CLUSPROP_ULARGE_INTEGER
    Public Base As CLUSPROP_VALUE
    Public li As ULong
End Structure
import ctypes
from ctypes import wintypes

class CLUSPROP_SYNTAX(ctypes.Structure):
    _fields_ = [
        ("dw", wintypes.DWORD),
        ("Anonymous", _Anonymous_e__Struct),
    ]

class CLUSPROP_VALUE(ctypes.Structure):
    _fields_ = [
        ("Syntax", CLUSPROP_SYNTAX),
        ("cbLength", wintypes.DWORD),
    ]

class CLUSPROP_ULARGE_INTEGER(ctypes.Structure):
    _fields_ = [
        ("Base", CLUSPROP_VALUE),
        ("li", ctypes.c_ulonglong),
    ]
#[repr(C)]
pub struct CLUSPROP_SYNTAX {
    pub dw: u32,
    pub Anonymous: _Anonymous_e__Struct,
}

#[repr(C)]
pub struct CLUSPROP_VALUE {
    pub Syntax: CLUSPROP_SYNTAX,
    pub cbLength: u32,
}

#[repr(C)]
pub struct CLUSPROP_ULARGE_INTEGER {
    pub Base: CLUSPROP_VALUE,
    pub li: u64,
}
import "golang.org/x/sys/windows"

type CLUSPROP_SYNTAX struct {
	dw uint32
	Anonymous _Anonymous_e__Struct
}

type CLUSPROP_VALUE struct {
	Syntax CLUSPROP_SYNTAX
	cbLength uint32
}

type CLUSPROP_ULARGE_INTEGER struct {
	Base CLUSPROP_VALUE
	li uint64
}
type
  CLUSPROP_SYNTAX = record
    dw: DWORD;
    Anonymous: _Anonymous_e__Struct;
  end;

  CLUSPROP_VALUE = record
    Syntax: CLUSPROP_SYNTAX;
    cbLength: DWORD;
  end;

  CLUSPROP_ULARGE_INTEGER = record
    Base: CLUSPROP_VALUE;
    li: UInt64;
  end;
const CLUSPROP_SYNTAX = extern struct {
    dw: u32,
    Anonymous: _Anonymous_e__Struct,
};

const CLUSPROP_VALUE = extern struct {
    Syntax: CLUSPROP_SYNTAX,
    cbLength: u32,
};

const CLUSPROP_ULARGE_INTEGER = extern struct {
    Base: CLUSPROP_VALUE,
    li: u64,
};
type
  CLUSPROP_SYNTAX {.bycopy.} = object
    dw: uint32
    Anonymous: _Anonymous_e__Struct

  CLUSPROP_VALUE {.bycopy.} = object
    Syntax: CLUSPROP_SYNTAX
    cbLength: uint32

  CLUSPROP_ULARGE_INTEGER {.bycopy.} = object
    Base: CLUSPROP_VALUE
    li: uint64
struct CLUSPROP_SYNTAX
{
    uint dw;
    _Anonymous_e__Struct Anonymous;
}

struct CLUSPROP_VALUE
{
    CLUSPROP_SYNTAX Syntax;
    uint cbLength;
}

struct CLUSPROP_ULARGE_INTEGER
{
    CLUSPROP_VALUE Base;
    ulong li;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CLUSPROP_ULARGE_INTEGER サイズ: 16 バイト(x64)
dim st, 4    ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; Base : CLUSPROP_VALUE (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; li : ULONGLONG (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global CLUSPROP_VALUE
    #field byte Syntax 4
    #field int cbLength
#endstruct

#defstruct global CLUSPROP_ULARGE_INTEGER
    #field CLUSPROP_VALUE Base
    #field int64 li
#endstruct

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