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

CLUS_PARTITION_INFO

構造体
サイズx64: 1120 バイト / x86: 1120 バイト

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

フィールド

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

ストレージ クラス リソースを記述するフラグで、 CLUSPROP_PIFLAGS 列挙型で列挙されます。

CLUSPROP_PIFLAG_STICKY (0x00000001)

ドライブ文字がスティッキー (固定) です。

CLUSPROP_PIFLAG_REMOVABLE (0x00000002)

ストレージ クラス リソースはリムーバブルです。

CLUSPROP_PIFLAG_USABLE (0x00000004)

ストレージ クラス リソースは、 クラスター サービスが使用できるファイル システムでフォーマットされています。

CLUSPROP_PIFLAG_DEFAULT_QUORUM (0x00000008)

SetClusterQuorumResource 関数でパーティションが指定されていない場合に、クォーラム ファイルの格納に使用されるパーティションです。 物理ディスクリソースの場合、50MB を超える最小の NTFS パーティションに自動的にこのフラグが設定されます。

szDeviceNameWCHAR520+4+4ストレージ クラス リソースのデバイス名です (「C:」など)。バックスラッシュは含まれません。
szVolumeLabelWCHAR520+524+524ストレージ クラス リソースのボリューム ラベルです。
dwSerialNumberDWORD4+1044+1044ストレージ クラス リソース ボリュームのシリアル番号です。
rgdwMaximumComponentLengthDWORD4+1048+1048指定されたファイル システムがサポートするファイル名コンポーネントの最大長 (文字数) の値です。ファイル名コンポーネントとは、 バックスラッシュで区切られたファイル名の一部分です。
dwFileSystemFlagsDWORD4+1052+1052

ファイル システムを記述する値です。次のフラグのうち 1 つ以上が有効です。

FS_CASE_IS_PRESERVED (0x00000002)

ファイル システムは、ストレージ クラス リソースに名前を配置するときにファイル名の大文字と小文字を保持します。

FS_CASE_SENSITIVE (0x00000001)

ファイル システムは、大文字と小文字を区別するファイル名をサポートします。

FS_UNICODE_STORED_ON_DISK (0x00000004)

ファイル システムは、ストレージ クラス リソース上に表示されるファイル名での Unicode をサポートします。

FS_PERSISTENT_ACLS (0x00000008)

ファイル システムは、アクセス制御リスト (ACL) を保持し、適用します。

szFileSystemWCHAR64+1056+1056ファイル システムの名前です (「FAT」や「NTFS」など)。

公式ドキュメント

ストレージ クラス リソースのボリュームとファイル システムを記述するデータを格納します。 CLUSPROP_PARTITION_INFO 構造体のデータ メンバーとして、また一部の コントロール コード操作の戻り値として使用されます。

解説(Remarks)

CLUS_PARTITION_INFO 構造体は、dwControlCode パラメーターに CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO が設定されている場合に ClusterResourceControl から返され、 dwControlCodeCLUSCTL_RESOURCE_TYPE_STORAGE_GET_AVAILABLE_DISKS が設定されている場合に ClusterResourceTypeControl から返されます。

物理ディスク リソースの作成を参照してください。

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

各言語での定義

#include <windows.h>

// CLUS_PARTITION_INFO  (x64 1120 / x86 1120 バイト)
typedef struct CLUS_PARTITION_INFO {
    DWORD dwFlags;
    WCHAR szDeviceName[260];
    WCHAR szVolumeLabel[260];
    DWORD dwSerialNumber;
    DWORD rgdwMaximumComponentLength;
    DWORD dwFileSystemFlags;
    WCHAR szFileSystem[32];
} CLUS_PARTITION_INFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CLUS_PARTITION_INFO
{
    public uint dwFlags;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 260)] public string szDeviceName;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 260)] public string szVolumeLabel;
    public uint dwSerialNumber;
    public uint rgdwMaximumComponentLength;
    public uint dwFileSystemFlags;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 32)] public string szFileSystem;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CLUS_PARTITION_INFO
    Public dwFlags As UInteger
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=260)> Public szDeviceName As String
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=260)> Public szVolumeLabel As String
    Public dwSerialNumber As UInteger
    Public rgdwMaximumComponentLength As UInteger
    Public dwFileSystemFlags As UInteger
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=32)> Public szFileSystem As String
End Structure
import ctypes
from ctypes import wintypes

class CLUS_PARTITION_INFO(ctypes.Structure):
    _fields_ = [
        ("dwFlags", wintypes.DWORD),
        ("szDeviceName", ctypes.c_wchar * 260),
        ("szVolumeLabel", ctypes.c_wchar * 260),
        ("dwSerialNumber", wintypes.DWORD),
        ("rgdwMaximumComponentLength", wintypes.DWORD),
        ("dwFileSystemFlags", wintypes.DWORD),
        ("szFileSystem", ctypes.c_wchar * 32),
    ]
#[repr(C)]
pub struct CLUS_PARTITION_INFO {
    pub dwFlags: u32,
    pub szDeviceName: [u16; 260],
    pub szVolumeLabel: [u16; 260],
    pub dwSerialNumber: u32,
    pub rgdwMaximumComponentLength: u32,
    pub dwFileSystemFlags: u32,
    pub szFileSystem: [u16; 32],
}
import "golang.org/x/sys/windows"

type CLUS_PARTITION_INFO struct {
	dwFlags uint32
	szDeviceName [260]uint16
	szVolumeLabel [260]uint16
	dwSerialNumber uint32
	rgdwMaximumComponentLength uint32
	dwFileSystemFlags uint32
	szFileSystem [32]uint16
}
type
  CLUS_PARTITION_INFO = record
    dwFlags: DWORD;
    szDeviceName: array[0..259] of WideChar;
    szVolumeLabel: array[0..259] of WideChar;
    dwSerialNumber: DWORD;
    rgdwMaximumComponentLength: DWORD;
    dwFileSystemFlags: DWORD;
    szFileSystem: array[0..31] of WideChar;
  end;
const CLUS_PARTITION_INFO = extern struct {
    dwFlags: u32,
    szDeviceName: [260]u16,
    szVolumeLabel: [260]u16,
    dwSerialNumber: u32,
    rgdwMaximumComponentLength: u32,
    dwFileSystemFlags: u32,
    szFileSystem: [32]u16,
};
type
  CLUS_PARTITION_INFO {.bycopy.} = object
    dwFlags: uint32
    szDeviceName: array[260, uint16]
    szVolumeLabel: array[260, uint16]
    dwSerialNumber: uint32
    rgdwMaximumComponentLength: uint32
    dwFileSystemFlags: uint32
    szFileSystem: array[32, uint16]
struct CLUS_PARTITION_INFO
{
    uint dwFlags;
    wchar[260] szDeviceName;
    wchar[260] szVolumeLabel;
    uint dwSerialNumber;
    uint rgdwMaximumComponentLength;
    uint dwFileSystemFlags;
    wchar[32] szFileSystem;
}

HSP用 定義

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

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

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