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

VSS_MGMT_OBJECT_UNION

共用体
サイズx64: 40 バイト / x86: 32 バイト

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

フィールド

フィールド型サイズx64x86説明
VolVSS_VOLUME_PROP16/8+0+0管理オブジェクトがボリュームの場合のVSS_VOLUME_PROP情報。
DiffVolVSS_DIFF_VOLUME_PROP32/24+0+0管理オブジェクトが差分ボリュームの場合のVSS_DIFF_VOLUME_PROP情報。
DiffAreaVSS_DIFF_AREA_PROP40/32+0+0管理オブジェクトが差分領域の場合のVSS_DIFF_AREA_PROP情報。

各言語での定義

#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;
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;
}
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
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),
    ]
#[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,
}
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_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;
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,
};
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
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;
}

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_UNION サイズ: 32 バイト(x86)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; Vol : VSS_VOLUME_PROP (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; DiffVol : VSS_DIFF_VOLUME_PROP (+0, 24byte)  varptr(st)+0 を基点に操作(24byte:入れ子/配列)
; DiffArea : VSS_DIFF_AREA_PROP (+0, 32byte)  varptr(st)+0 を基点に操作(32byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; VSS_MGMT_OBJECT_UNION サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; Vol : VSS_VOLUME_PROP (+0, 16byte)  varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; DiffVol : VSS_DIFF_VOLUME_PROP (+0, 32byte)  varptr(st)+0 を基点に操作(32byte:入れ子/配列)
; DiffArea : VSS_DIFF_AREA_PROP (+0, 40byte)  varptr(st)+0 を基点に操作(40byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global VSS_VOLUME_PROP
    #field intptr m_pwszVolumeName
    #field intptr m_pwszVolumeDisplayName
#endstruct

#defstruct global VSS_DIFF_VOLUME_PROP
    #field intptr m_pwszVolumeName
    #field intptr m_pwszVolumeDisplayName
    #field int64 m_llVolumeFreeSpace
    #field int64 m_llVolumeTotalSpace
#endstruct

#defstruct global VSS_DIFF_AREA_PROP
    #field intptr m_pwszVolumeName
    #field intptr m_pwszDiffAreaVolumeName
    #field int64 m_llMaximumDiffSpace
    #field int64 m_llAllocatedDiffSpace
    #field int64 m_llUsedDiffSpace
#endstruct

#defstruct global VSS_MGMT_OBJECT_UNION
    #field VSS_VOLUME_PROP Vol
    #field VSS_DIFF_VOLUME_PROP DiffVol
    #field VSS_DIFF_AREA_PROP DiffArea
#endstruct

stdim st, VSS_MGMT_OBJECT_UNION        ; NSTRUCT 変数を確保