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

CLUSPROP_SYNTAX

共用体
📘 Microsoft Learn (日本語) · English
サイズx64: 4 バイト / x86: 4 バイト

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

フィールド

フィールド型サイズx64x86説明
dwDWORD4+0+0データ値の形式と型を記述する DWORD です。指定可能な値は CLUSTER_PROPERTY_SYNTAX 列挙型で定義されています。
Anonymous_Anonymous_e__Struct4+0+0型と長さの各WORDに分けてアクセスする無名構造体メンバ。

構造体: _Anonymous_e__Struct x64 4B / x86 4B

フィールド型サイズx64x86説明
wFormatWORD2+0+0

データ値の形式のみを記述する数値です。ClusAPI.h では次の値が定義されており、 CLUSTER_PROPERTY_FORMAT 列挙型として列挙されています。

wFormat.CLUSPROP_FORMAT_BINARY (1)

データはバイナリ値です。

wFormat.CLUSPROP_FORMAT_DWORD (2)

データは DWORD 値です。

wFormat.CLUSPROP_FORMAT_EXPAND_SZ (4)

データは、環境変数への参照が展開されていない、NULL で終わる Unicode 文字列です。

wFormat.CLUSPROP_FORMAT_EXPANDED_SZ (8)

データは、環境変数への参照が展開された、NULL で終わる Unicode 文字列です。

wFormat.CLUSPROP_FORMAT_FILETIME (12 (0xC))

データは FILETIME です。

wFormat.CLUSPROP_FORMAT_LARGE_INTEGER (10 (0xA))

データは符号付きの大きな整数です。

wFormat.CLUSPROP_FORMAT_LONG (7)

データは符号付きの LONG 値です。

wFormat.CLUSPROP_FORMAT_MULTI_SZ (5)

データは NULL で終わる Unicode 文字列の配列です。

wFormat.CLUSPROP_FORMAT_SECURITY_DESCRIPTOR (9)

データは 自己相対 形式の SECURITY_DESCRIPTOR です。自己相対セキュリティ記述子の詳細については、 Absolute and Self-Relative Security Descriptors を参照してください。

wFormat.CLUSPROP_FORMAT_SZ (3)

データは NULL で終わる Unicode 文字列です。

wFormat.CLUSPROP_FORMAT_ULARGE_INTEGER (6)

データは符号なしの大きな整数です。

wFormat.CLUSPROP_FORMAT_UNKNOWN (0)

データは不明な形式です。

wFormat.CLUSPROP_FORMAT_USER (32768 (0x8000))

データはユーザー定義の形式です。

wFormat.CLUSPROP_FORMAT_WORD (11 (0xB))

データは WORD 値です。

wTypeWORD2+2+2

データ値の型のみを記述する数値です。指定可能な値は CLUSTER_PROPERTY_TYPE 列挙型で定義されています。

wType.CLUSPROP_TYPE_DISK_NUMBER (7)

ディスクリソースの番号の値を表します。ディスク番号の値は CLUSPROP_DISK_NUMBER 構造体で表現されます。

wType.CLUSPROP_TYPE_DISK_SERIALNUMBER (10 (0xA))

ディスクリソースのシリアル番号を表します。

wType.CLUSPROP_TYPE_DISK_GUID (11 (0xB))

ディスクリソースの GUID を表します。

wType.CLUSPROP_TYPE_DISK_SIZE (12 (0xC))

ディスクの合計サイズを表します。

wType.CLUSPROP_TYPE_ENDMARK (0)

そのデータ値が、プロパティリストまたは値リストの最後のエントリであることを示します。

wType.CLUSPROP_TYPE_LIST_VALUE (1)

プロパティリスト内のデータ値を表します。たとえば、プロパティの検証操作のために コントロールコード関数 に渡されるプロパティリストでは、 各プロパティ値に CLUSPROP_TYPE_LIST_VALUE を含める必要があります。

wType.CLUSPROP_TYPE_NAME (4)

プロパティ名など、名前として使用されるデータ値を表します。名前の値は CLUSPROP_PROPERTY_NAME 構造体で表現されます。

wType.CLUSPROP_TYPE_PARTITION_INFO (8)

デバイス名やボリュームラベルなど、ディスクリソースに関する一連の情報を表します。 パーティションデータは CLUSPROP_PARTITION_INFO 構造体で表現されます。

wType.CLUSPROP_TYPE_PARTITION_INFO_EX (13 (0xD))

デバイス名やボリュームラベルなど、ディスクリソースに関する一連の情報を表します。 パーティションデータは CLUSPROP_PARTITION_INFO_EX 構造体で表現されます。

wType.CLUSPROP_TYPE_RESCLASS (2)

リソースクラスの情報を表します。リソースクラスの値は CLUSPROP_RESOURCE_CLASS 構造体で記述されます。リソースクラスは、アプリケーションが次のいずれかのコントロールコードを指定して ClusterResourceControl または ClusterResourceTypeControl を 呼び出したときに返されます。

CLUSCTL_RESOURCE_GET_CLASS_INFO

CLUSCTL_RESOURCE_TYPE_GET_CLASS_INFO

CLUSCTL_RESOURCE_TYPE_GET_REQUIRED_DEPENDENCIES

wType.CLUSPROP_TYPE_SCSI_ADDRESS (6)

IP Address リソースの Address プロパティを表します。SCSI アドレスの値は CLUSPROP_SCSI_ADDRESS 構造体で表現されます。

wType.CLUSPROP_TYPE_SIGNATURE (5)

ディスクリソースの Signature プロパティを表します。シグネチャの値は CLUSPROP_DISK_SIGNATURE 構造体で表現されます。

wType.CLUSPROP_TYPE_UNKNOWN (-1)

型が不明です。

wType.CLUSPROP_TYPE_USER (32768 (0x8000))

ユーザーが独自の型を定義するための範囲の先頭を表します。ユーザー定義のプライベートプロパティには この型を関連付けます。

公式ドキュメント

データ値の形式と型を記述します。CLUSPROP_VALUE 構造体の Syntax メンバーとして使用されます。

解説(Remarks)

コントロールコード関数 から返されたデータを解析する際に、 wType メンバーがアプリケーションで解釈できない型を定義している場合は、この構造体の wFormat メンバーを使用してください。

例

Creating Physical Disk Resources および Building with CLUSPROP_BUFFER_HELPER を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CLUSPROP_SYNTAX
{
    public uint dw;
    public _Anonymous_e__Struct Anonymous;
}
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
import ctypes
from ctypes import wintypes

class CLUSPROP_SYNTAX(ctypes.Structure):
    _fields_ = [
        ("dw", wintypes.DWORD),
        ("Anonymous", _Anonymous_e__Struct),
    ]
#[repr(C)]
pub struct CLUSPROP_SYNTAX {
    pub dw: u32,
    pub Anonymous: _Anonymous_e__Struct,
}
import "golang.org/x/sys/windows"

type CLUSPROP_SYNTAX struct {
	dw uint32
	Anonymous _Anonymous_e__Struct
}
type
  CLUSPROP_SYNTAX = record
    dw: DWORD;
    Anonymous: _Anonymous_e__Struct;
  end;
const CLUSPROP_SYNTAX = extern struct {
    dw: u32,
    Anonymous: _Anonymous_e__Struct,
};
type
  CLUSPROP_SYNTAX {.bycopy.} = object
    dw: uint32
    Anonymous: _Anonymous_e__Struct
struct CLUSPROP_SYNTAX
{
    uint dw;
    _Anonymous_e__Struct Anonymous;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CLUSPROP_SYNTAX サイズ: 4 バイト(x64)
dim st, 1    ; 4byte整数×1(構造体サイズ 4 / 4 切り上げ)
; dw : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Struct (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CLUSPROP_SYNTAX
    #field int dw
    #field _Anonymous_e__Struct Anonymous
#endstruct

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