Win32 API 日本語リファレンス
ホーム › Storage.Vss › VSS_MGMT_OBJECT_PROP

VSS_MGMT_OBJECT_PROP

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

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

フィールド

フィールド型サイズx64x86説明
TypeVSS_MGMT_OBJECT_TYPE4+0+0管理オブジェクトの種類を示すVSS_MGMT_OBJECT_TYPE列挙値。
ObjVSS_MGMT_OBJECT_UNION40/32+8+8種類に応じた管理プロパティを格納するVSS_MGMT_OBJECT_UNION共用体。

各言語での定義

#include <windows.h>

// VSS_VOLUME_PROP  (x64 16 / x86 8 バイト)
typedef struct VSS_VOLUME_PROP {
    WORD* m_pwszVolumeName;
    WORD* m_pwszVolumeDisplayName;
} VSS_VOLUME_PROP;

// VSS_DIFF_VOLUME_PROP  (x64 32 / x86 24 バイト)
typedef struct VSS_DIFF_VOLUME_PROP {
    WORD* m_pwszVolumeName;
    WORD* m_pwszVolumeDisplayName;
    LONGLONG m_llVolumeFreeSpace;
    LONGLONG m_llVolumeTotalSpace;
} VSS_DIFF_VOLUME_PROP;

// VSS_DIFF_AREA_PROP  (x64 40 / x86 32 バイト)
typedef struct VSS_DIFF_AREA_PROP {
    WORD* m_pwszVolumeName;
    WORD* m_pwszDiffAreaVolumeName;
    LONGLONG m_llMaximumDiffSpace;
    LONGLONG m_llAllocatedDiffSpace;
    LONGLONG m_llUsedDiffSpace;
} VSS_DIFF_AREA_PROP;

// VSS_MGMT_OBJECT_UNION  (x64 40 / x86 32 バイト)
typedef struct VSS_MGMT_OBJECT_UNION {
    VSS_VOLUME_PROP Vol;
    VSS_DIFF_VOLUME_PROP DiffVol;
    VSS_DIFF_AREA_PROP DiffArea;
} VSS_MGMT_OBJECT_UNION;

// VSS_MGMT_OBJECT_PROP  (x64 48 / x86 40 バイト)
typedef struct VSS_MGMT_OBJECT_PROP {
    VSS_MGMT_OBJECT_TYPE Type;
    VSS_MGMT_OBJECT_UNION Obj;
} VSS_MGMT_OBJECT_PROP;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VSS_VOLUME_PROP
{
    public IntPtr m_pwszVolumeName;
    public IntPtr m_pwszVolumeDisplayName;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VSS_DIFF_VOLUME_PROP
{
    public IntPtr m_pwszVolumeName;
    public IntPtr m_pwszVolumeDisplayName;
    public long m_llVolumeFreeSpace;
    public long m_llVolumeTotalSpace;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VSS_DIFF_AREA_PROP
{
    public IntPtr m_pwszVolumeName;
    public IntPtr m_pwszDiffAreaVolumeName;
    public long m_llMaximumDiffSpace;
    public long m_llAllocatedDiffSpace;
    public long m_llUsedDiffSpace;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VSS_MGMT_OBJECT_UNION
{
    public VSS_VOLUME_PROP Vol;
    public VSS_DIFF_VOLUME_PROP DiffVol;
    public VSS_DIFF_AREA_PROP DiffArea;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VSS_MGMT_OBJECT_PROP
{
    public int Type;
    public VSS_MGMT_OBJECT_UNION Obj;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VSS_VOLUME_PROP
    Public m_pwszVolumeName As IntPtr
    Public m_pwszVolumeDisplayName As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VSS_DIFF_VOLUME_PROP
    Public m_pwszVolumeName As IntPtr
    Public m_pwszVolumeDisplayName As IntPtr
    Public m_llVolumeFreeSpace As Long
    Public m_llVolumeTotalSpace As Long
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VSS_DIFF_AREA_PROP
    Public m_pwszVolumeName As IntPtr
    Public m_pwszDiffAreaVolumeName As IntPtr
    Public m_llMaximumDiffSpace As Long
    Public m_llAllocatedDiffSpace As Long
    Public m_llUsedDiffSpace As Long
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VSS_MGMT_OBJECT_UNION
    Public Vol As VSS_VOLUME_PROP
    Public DiffVol As VSS_DIFF_VOLUME_PROP
    Public DiffArea As VSS_DIFF_AREA_PROP
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VSS_MGMT_OBJECT_PROP
    Public Type As Integer
    Public Obj As VSS_MGMT_OBJECT_UNION
End Structure
import ctypes
from ctypes import wintypes

class VSS_VOLUME_PROP(ctypes.Structure):
    _fields_ = [
        ("m_pwszVolumeName", ctypes.c_void_p),
        ("m_pwszVolumeDisplayName", ctypes.c_void_p),
    ]

class VSS_DIFF_VOLUME_PROP(ctypes.Structure):
    _fields_ = [
        ("m_pwszVolumeName", ctypes.c_void_p),
        ("m_pwszVolumeDisplayName", ctypes.c_void_p),
        ("m_llVolumeFreeSpace", ctypes.c_longlong),
        ("m_llVolumeTotalSpace", ctypes.c_longlong),
    ]

class VSS_DIFF_AREA_PROP(ctypes.Structure):
    _fields_ = [
        ("m_pwszVolumeName", ctypes.c_void_p),
        ("m_pwszDiffAreaVolumeName", ctypes.c_void_p),
        ("m_llMaximumDiffSpace", ctypes.c_longlong),
        ("m_llAllocatedDiffSpace", ctypes.c_longlong),
        ("m_llUsedDiffSpace", ctypes.c_longlong),
    ]

class VSS_MGMT_OBJECT_UNION(ctypes.Structure):
    _fields_ = [
        ("Vol", VSS_VOLUME_PROP),
        ("DiffVol", VSS_DIFF_VOLUME_PROP),
        ("DiffArea", VSS_DIFF_AREA_PROP),
    ]

class VSS_MGMT_OBJECT_PROP(ctypes.Structure):
    _fields_ = [
        ("Type", ctypes.c_int),
        ("Obj", VSS_MGMT_OBJECT_UNION),
    ]
#[repr(C)]
pub struct VSS_VOLUME_PROP {
    pub m_pwszVolumeName: *mut core::ffi::c_void,
    pub m_pwszVolumeDisplayName: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct VSS_DIFF_VOLUME_PROP {
    pub m_pwszVolumeName: *mut core::ffi::c_void,
    pub m_pwszVolumeDisplayName: *mut core::ffi::c_void,
    pub m_llVolumeFreeSpace: i64,
    pub m_llVolumeTotalSpace: i64,
}

#[repr(C)]
pub struct VSS_DIFF_AREA_PROP {
    pub m_pwszVolumeName: *mut core::ffi::c_void,
    pub m_pwszDiffAreaVolumeName: *mut core::ffi::c_void,
    pub m_llMaximumDiffSpace: i64,
    pub m_llAllocatedDiffSpace: i64,
    pub m_llUsedDiffSpace: i64,
}

#[repr(C)]
pub struct VSS_MGMT_OBJECT_UNION {
    pub Vol: VSS_VOLUME_PROP,
    pub DiffVol: VSS_DIFF_VOLUME_PROP,
    pub DiffArea: VSS_DIFF_AREA_PROP,
}

#[repr(C)]
pub struct VSS_MGMT_OBJECT_PROP {
    pub Type: i32,
    pub Obj: VSS_MGMT_OBJECT_UNION,
}
import "golang.org/x/sys/windows"

type VSS_VOLUME_PROP struct {
	m_pwszVolumeName uintptr
	m_pwszVolumeDisplayName uintptr
}

type VSS_DIFF_VOLUME_PROP struct {
	m_pwszVolumeName uintptr
	m_pwszVolumeDisplayName uintptr
	m_llVolumeFreeSpace int64
	m_llVolumeTotalSpace int64
}

type VSS_DIFF_AREA_PROP struct {
	m_pwszVolumeName uintptr
	m_pwszDiffAreaVolumeName uintptr
	m_llMaximumDiffSpace int64
	m_llAllocatedDiffSpace int64
	m_llUsedDiffSpace int64
}

type VSS_MGMT_OBJECT_UNION struct {
	Vol VSS_VOLUME_PROP
	DiffVol VSS_DIFF_VOLUME_PROP
	DiffArea VSS_DIFF_AREA_PROP
}

type VSS_MGMT_OBJECT_PROP struct {
	Type int32
	Obj VSS_MGMT_OBJECT_UNION
}
type
  VSS_VOLUME_PROP = record
    m_pwszVolumeName: Pointer;
    m_pwszVolumeDisplayName: Pointer;
  end;

  VSS_DIFF_VOLUME_PROP = record
    m_pwszVolumeName: Pointer;
    m_pwszVolumeDisplayName: Pointer;
    m_llVolumeFreeSpace: Int64;
    m_llVolumeTotalSpace: Int64;
  end;

  VSS_DIFF_AREA_PROP = record
    m_pwszVolumeName: Pointer;
    m_pwszDiffAreaVolumeName: Pointer;
    m_llMaximumDiffSpace: Int64;
    m_llAllocatedDiffSpace: Int64;
    m_llUsedDiffSpace: Int64;
  end;

  VSS_MGMT_OBJECT_UNION = record
    Vol: VSS_VOLUME_PROP;
    DiffVol: VSS_DIFF_VOLUME_PROP;
    DiffArea: VSS_DIFF_AREA_PROP;
  end;

  VSS_MGMT_OBJECT_PROP = record
    Type: Integer;
    Obj: VSS_MGMT_OBJECT_UNION;
  end;
const VSS_VOLUME_PROP = extern struct {
    m_pwszVolumeName: ?*anyopaque,
    m_pwszVolumeDisplayName: ?*anyopaque,
};

const VSS_DIFF_VOLUME_PROP = extern struct {
    m_pwszVolumeName: ?*anyopaque,
    m_pwszVolumeDisplayName: ?*anyopaque,
    m_llVolumeFreeSpace: i64,
    m_llVolumeTotalSpace: i64,
};

const VSS_DIFF_AREA_PROP = extern struct {
    m_pwszVolumeName: ?*anyopaque,
    m_pwszDiffAreaVolumeName: ?*anyopaque,
    m_llMaximumDiffSpace: i64,
    m_llAllocatedDiffSpace: i64,
    m_llUsedDiffSpace: i64,
};

const VSS_MGMT_OBJECT_UNION = extern struct {
    Vol: VSS_VOLUME_PROP,
    DiffVol: VSS_DIFF_VOLUME_PROP,
    DiffArea: VSS_DIFF_AREA_PROP,
};

const VSS_MGMT_OBJECT_PROP = extern struct {
    Type: i32,
    Obj: VSS_MGMT_OBJECT_UNION,
};
type
  VSS_VOLUME_PROP {.bycopy.} = object
    m_pwszVolumeName: pointer
    m_pwszVolumeDisplayName: pointer

  VSS_DIFF_VOLUME_PROP {.bycopy.} = object
    m_pwszVolumeName: pointer
    m_pwszVolumeDisplayName: pointer
    m_llVolumeFreeSpace: int64
    m_llVolumeTotalSpace: int64

  VSS_DIFF_AREA_PROP {.bycopy.} = object
    m_pwszVolumeName: pointer
    m_pwszDiffAreaVolumeName: pointer
    m_llMaximumDiffSpace: int64
    m_llAllocatedDiffSpace: int64
    m_llUsedDiffSpace: int64

  VSS_MGMT_OBJECT_UNION {.bycopy.} = object
    Vol: VSS_VOLUME_PROP
    DiffVol: VSS_DIFF_VOLUME_PROP
    DiffArea: VSS_DIFF_AREA_PROP

  VSS_MGMT_OBJECT_PROP {.bycopy.} = object
    Type: int32
    Obj: VSS_MGMT_OBJECT_UNION
struct VSS_VOLUME_PROP
{
    void* m_pwszVolumeName;
    void* m_pwszVolumeDisplayName;
}

struct VSS_DIFF_VOLUME_PROP
{
    void* m_pwszVolumeName;
    void* m_pwszVolumeDisplayName;
    long m_llVolumeFreeSpace;
    long m_llVolumeTotalSpace;
}

struct VSS_DIFF_AREA_PROP
{
    void* m_pwszVolumeName;
    void* m_pwszDiffAreaVolumeName;
    long m_llMaximumDiffSpace;
    long m_llAllocatedDiffSpace;
    long m_llUsedDiffSpace;
}

struct VSS_MGMT_OBJECT_UNION
{
    VSS_VOLUME_PROP Vol;
    VSS_DIFF_VOLUME_PROP DiffVol;
    VSS_DIFF_AREA_PROP DiffArea;
}

struct VSS_MGMT_OBJECT_PROP
{
    int Type;
    VSS_MGMT_OBJECT_UNION Obj;
}

HSP用 定義

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

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

stdim st, VSS_MGMT_OBJECT_PROP        ; NSTRUCT 変数を確保
st->Type = 100
mes "Type=" + st->Type
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。