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

CLUSPROP_LARGE_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構造体である。
liLONGLONG8+8+8符号付きの大整数値です。

公式ドキュメント

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

解説(Remarks)

値リスト、プロパティ リスト、 パラメーター ブロックのような DWORD 境界にそろえられた構造体で大整数値を参照する場合は注意してください。Itanium ベースのシステム用 Windows Server では、 自然な境界にそろえられた大整数値は必ず 0h または 8h で終わるアドレスから始まります。 DWORD 境界へのそろえによって、大きな値がそろっていない境界 (4h または Ch で終わるアドレス) から始まることがあり、 データの読み取りまたは書き込み時にアラインメント フォールトが発生します。大きな値の上位 DWORD と下位 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_LARGE_INTEGER  (x64 16 / x86 16 バイト)
typedef struct CLUSPROP_LARGE_INTEGER {
    CLUSPROP_VALUE Base;
    LONGLONG li;
} CLUSPROP_LARGE_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_LARGE_INTEGER
{
    public CLUSPROP_VALUE Base;
    public long 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_LARGE_INTEGER
    Public Base As CLUSPROP_VALUE
    Public li As Long
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_LARGE_INTEGER(ctypes.Structure):
    _fields_ = [
        ("Base", CLUSPROP_VALUE),
        ("li", ctypes.c_longlong),
    ]
#[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_LARGE_INTEGER {
    pub Base: CLUSPROP_VALUE,
    pub li: i64,
}
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_LARGE_INTEGER struct {
	Base CLUSPROP_VALUE
	li int64
}
type
  CLUSPROP_SYNTAX = record
    dw: DWORD;
    Anonymous: _Anonymous_e__Struct;
  end;

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

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

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

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

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

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

struct CLUSPROP_VALUE
{
    CLUSPROP_SYNTAX Syntax;
    uint cbLength;
}

struct CLUSPROP_LARGE_INTEGER
{
    CLUSPROP_VALUE Base;
    long 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_LARGE_INTEGER サイズ: 16 バイト(x64)
dim st, 4    ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; Base : CLUSPROP_VALUE (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; li : LONGLONG (+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_LARGE_INTEGER
    #field CLUSPROP_VALUE Base
    #field int64 li
#endstruct

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