Win32 API 日本語リファレンス
ホームSystem.RemoteDesktop › WTSINFOEX_LEVEL1_W

WTSINFOEX_LEVEL1_W

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

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

フィールド

フィールドサイズx64x86説明
SessionIdDWORD4+0+0セッション識別子です。
SessionStateWTS_CONNECTSTATE_CLASS4+4+4リモート デスクトップ サービス セッションの接続状態を指定する WTS_CONNECTSTATE_CLASS 列挙型の値です。
SessionFlagsINT4+8+8

セッションの状態です。次の値のうち 1 つ以上を指定できます。

WTS_SESSIONSTATE_UNKNOWN (4294967295 (0xFFFFFFFF))

セッションの状態は不明です。

WTS_SESSIONSTATE_LOCK (0 (0x0))

セッションはロックされています。

WTS_SESSIONSTATE_UNLOCK (1 (0x1))

セッションはロック解除されています。

Windows Server 2008 R2 および Windows 7: コードの不具合により、WTS_SESSIONSTATE_LOCK フラグと WTS_SESSIONSTATE_UNLOCK フラグの用法が逆になっています。つまり、WTS_SESSIONSTATE_LOCK はセッションがロック解除されていることを示し、WTS_SESSIONSTATE_UNLOCK はセッションがロックされていることを示します。

WinStationNameWCHAR66+12+12セッションのウィンドウ ステーション名を格納する、null で終わる文字列です。
UserNameWCHAR42+78+78セッションを所有するユーザーの名前を格納する、null で終わる文字列です。
DomainNameWCHAR36+120+120ユーザーが所属するドメインの名前を格納する、null で終わる文字列です。
LogonTimeLONGLONG8+160+160ユーザーがセッションにログオンした時刻です。この値は、1601 年 1 月 1 日の協定世界時 (グリニッジ標準時) からの 100 ナノ秒間隔の数を表す large integer として格納されます。
ConnectTimeLONGLONG8+168+168クライアントがセッションに最後に接続した時刻です。この値は、1601 年 1 月 1 日の協定世界時からの 100 ナノ秒間隔の数を表す large integer として格納されます。
DisconnectTimeLONGLONG8+176+176クライアントがセッションから最後に切断した時刻です。この値は、1601 年 1 月 1 日の協定世界時からの 100 ナノ秒間隔の数を表す large integer として格納されます。
LastInputTimeLONGLONG8+184+184セッションで最後にユーザー入力が行われた時刻です。この値は、1601 年 1 月 1 日の協定世界時からの 100 ナノ秒間隔の数を表す large integer として格納されます。
CurrentTimeLONGLONG8+192+192この構造体に値が設定された時刻です。この値は、1601 年 1 月 1 日の協定世界時からの 100 ナノ秒間隔の数を表す large integer として格納されます。
IncomingBytesDWORD4+200+200クライアントが接続してから、クライアントからサーバーに送信された非圧縮のリモート デスクトップ プロトコル (RDP) データのバイト数です。
OutgoingBytesDWORD4+204+204クライアントが接続してから、サーバーからクライアントに送信された非圧縮の RDP データのバイト数です。
IncomingFramesDWORD4+208+208クライアントが接続してから、クライアントからサーバーに送信された RDP データのフレーム数です。
OutgoingFramesDWORD4+212+212クライアントが接続してから、サーバーからクライアントに送信された RDP データのフレーム数です。
IncomingCompressedBytesDWORD4+216+216クライアントが接続してから、クライアントからサーバーに送信された圧縮済み RDP データのバイト数です。
OutgoingCompressedBytesDWORD4+220+220

クライアントが接続してから、サーバーからクライアントに送信された圧縮済み RDP データのバイト数です。

- SessionFlags.WTS_SESSIONSTATE_LOCK (0 (0x0))

セッションはロックされています。

- SessionFlags.WTS_SESSIONSTATE_UNKNOWN (4294967295 (0xFFFFFFFF))

セッションの状態は不明です。

- SessionFlags.WTS_SESSIONSTATE_UNLOCK (1 (0x1))

セッションはロック解除されています。

公式ドキュメント

リモート デスクトップ サービス セッションに関する拡張情報を格納します。

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

各言語での定義

#include <windows.h>

// WTSINFOEX_LEVEL1_W  (x64 224 / x86 224 バイト)
typedef struct WTSINFOEX_LEVEL1_W {
    DWORD SessionId;
    WTS_CONNECTSTATE_CLASS SessionState;
    INT SessionFlags;
    WCHAR WinStationName[33];
    WCHAR UserName[21];
    WCHAR DomainName[18];
    LONGLONG LogonTime;
    LONGLONG ConnectTime;
    LONGLONG DisconnectTime;
    LONGLONG LastInputTime;
    LONGLONG CurrentTime;
    DWORD IncomingBytes;
    DWORD OutgoingBytes;
    DWORD IncomingFrames;
    DWORD OutgoingFrames;
    DWORD IncomingCompressedBytes;
    DWORD OutgoingCompressedBytes;
} WTSINFOEX_LEVEL1_W;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WTSINFOEX_LEVEL1_W
{
    public uint SessionId;
    public int SessionState;
    public int SessionFlags;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 33)] public string WinStationName;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 21)] public string UserName;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 18)] public string DomainName;
    public long LogonTime;
    public long ConnectTime;
    public long DisconnectTime;
    public long LastInputTime;
    public long CurrentTime;
    public uint IncomingBytes;
    public uint OutgoingBytes;
    public uint IncomingFrames;
    public uint OutgoingFrames;
    public uint IncomingCompressedBytes;
    public uint OutgoingCompressedBytes;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WTSINFOEX_LEVEL1_W
    Public SessionId As UInteger
    Public SessionState As Integer
    Public SessionFlags As Integer
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=33)> Public WinStationName As String
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=21)> Public UserName As String
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=18)> Public DomainName As String
    Public LogonTime As Long
    Public ConnectTime As Long
    Public DisconnectTime As Long
    Public LastInputTime As Long
    Public CurrentTime As Long
    Public IncomingBytes As UInteger
    Public OutgoingBytes As UInteger
    Public IncomingFrames As UInteger
    Public OutgoingFrames As UInteger
    Public IncomingCompressedBytes As UInteger
    Public OutgoingCompressedBytes As UInteger
End Structure
import ctypes
from ctypes import wintypes

class WTSINFOEX_LEVEL1_W(ctypes.Structure):
    _fields_ = [
        ("SessionId", wintypes.DWORD),
        ("SessionState", ctypes.c_int),
        ("SessionFlags", ctypes.c_int),
        ("WinStationName", ctypes.c_wchar * 33),
        ("UserName", ctypes.c_wchar * 21),
        ("DomainName", ctypes.c_wchar * 18),
        ("LogonTime", ctypes.c_longlong),
        ("ConnectTime", ctypes.c_longlong),
        ("DisconnectTime", ctypes.c_longlong),
        ("LastInputTime", ctypes.c_longlong),
        ("CurrentTime", ctypes.c_longlong),
        ("IncomingBytes", wintypes.DWORD),
        ("OutgoingBytes", wintypes.DWORD),
        ("IncomingFrames", wintypes.DWORD),
        ("OutgoingFrames", wintypes.DWORD),
        ("IncomingCompressedBytes", wintypes.DWORD),
        ("OutgoingCompressedBytes", wintypes.DWORD),
    ]
#[repr(C)]
pub struct WTSINFOEX_LEVEL1_W {
    pub SessionId: u32,
    pub SessionState: i32,
    pub SessionFlags: i32,
    pub WinStationName: [u16; 33],
    pub UserName: [u16; 21],
    pub DomainName: [u16; 18],
    pub LogonTime: i64,
    pub ConnectTime: i64,
    pub DisconnectTime: i64,
    pub LastInputTime: i64,
    pub CurrentTime: i64,
    pub IncomingBytes: u32,
    pub OutgoingBytes: u32,
    pub IncomingFrames: u32,
    pub OutgoingFrames: u32,
    pub IncomingCompressedBytes: u32,
    pub OutgoingCompressedBytes: u32,
}
import "golang.org/x/sys/windows"

type WTSINFOEX_LEVEL1_W struct {
	SessionId uint32
	SessionState int32
	SessionFlags int32
	WinStationName [33]uint16
	UserName [21]uint16
	DomainName [18]uint16
	LogonTime int64
	ConnectTime int64
	DisconnectTime int64
	LastInputTime int64
	CurrentTime int64
	IncomingBytes uint32
	OutgoingBytes uint32
	IncomingFrames uint32
	OutgoingFrames uint32
	IncomingCompressedBytes uint32
	OutgoingCompressedBytes uint32
}
type
  WTSINFOEX_LEVEL1_W = record
    SessionId: DWORD;
    SessionState: Integer;
    SessionFlags: Integer;
    WinStationName: array[0..32] of WideChar;
    UserName: array[0..20] of WideChar;
    DomainName: array[0..17] of WideChar;
    LogonTime: Int64;
    ConnectTime: Int64;
    DisconnectTime: Int64;
    LastInputTime: Int64;
    CurrentTime: Int64;
    IncomingBytes: DWORD;
    OutgoingBytes: DWORD;
    IncomingFrames: DWORD;
    OutgoingFrames: DWORD;
    IncomingCompressedBytes: DWORD;
    OutgoingCompressedBytes: DWORD;
  end;
const WTSINFOEX_LEVEL1_W = extern struct {
    SessionId: u32,
    SessionState: i32,
    SessionFlags: i32,
    WinStationName: [33]u16,
    UserName: [21]u16,
    DomainName: [18]u16,
    LogonTime: i64,
    ConnectTime: i64,
    DisconnectTime: i64,
    LastInputTime: i64,
    CurrentTime: i64,
    IncomingBytes: u32,
    OutgoingBytes: u32,
    IncomingFrames: u32,
    OutgoingFrames: u32,
    IncomingCompressedBytes: u32,
    OutgoingCompressedBytes: u32,
};
type
  WTSINFOEX_LEVEL1_W {.bycopy.} = object
    SessionId: uint32
    SessionState: int32
    SessionFlags: int32
    WinStationName: array[33, uint16]
    UserName: array[21, uint16]
    DomainName: array[18, uint16]
    LogonTime: int64
    ConnectTime: int64
    DisconnectTime: int64
    LastInputTime: int64
    CurrentTime: int64
    IncomingBytes: uint32
    OutgoingBytes: uint32
    IncomingFrames: uint32
    OutgoingFrames: uint32
    IncomingCompressedBytes: uint32
    OutgoingCompressedBytes: uint32
struct WTSINFOEX_LEVEL1_W
{
    uint SessionId;
    int SessionState;
    int SessionFlags;
    wchar[33] WinStationName;
    wchar[21] UserName;
    wchar[18] DomainName;
    long LogonTime;
    long ConnectTime;
    long DisconnectTime;
    long LastInputTime;
    long CurrentTime;
    uint IncomingBytes;
    uint OutgoingBytes;
    uint IncomingFrames;
    uint OutgoingFrames;
    uint IncomingCompressedBytes;
    uint OutgoingCompressedBytes;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WTSINFOEX_LEVEL1_W サイズ: 224 バイト(x64)
dim st, 56    ; 4byte整数×56(構造体サイズ 224 / 4 切り上げ)
; SessionId : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; SessionState : WTS_CONNECTSTATE_CLASS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; SessionFlags : INT (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; WinStationName : WCHAR (+12, 66byte)  varptr(st)+12 を基点に操作(66byte:入れ子/配列)
; UserName : WCHAR (+78, 42byte)  varptr(st)+78 を基点に操作(42byte:入れ子/配列)
; DomainName : WCHAR (+120, 36byte)  varptr(st)+120 を基点に操作(36byte:入れ子/配列)
; LogonTime : LONGLONG (+160, 8byte)  qpoke st,160,値 / qpeek(st,160)  ※IronHSPのみ。3.7/3.8は lpoke st,160,下位 : lpoke st,164,上位
; ConnectTime : LONGLONG (+168, 8byte)  qpoke st,168,値 / qpeek(st,168)  ※IronHSPのみ。3.7/3.8は lpoke st,168,下位 : lpoke st,172,上位
; DisconnectTime : LONGLONG (+176, 8byte)  qpoke st,176,値 / qpeek(st,176)  ※IronHSPのみ。3.7/3.8は lpoke st,176,下位 : lpoke st,180,上位
; LastInputTime : LONGLONG (+184, 8byte)  qpoke st,184,値 / qpeek(st,184)  ※IronHSPのみ。3.7/3.8は lpoke st,184,下位 : lpoke st,188,上位
; CurrentTime : LONGLONG (+192, 8byte)  qpoke st,192,値 / qpeek(st,192)  ※IronHSPのみ。3.7/3.8は lpoke st,192,下位 : lpoke st,196,上位
; IncomingBytes : DWORD (+200, 4byte)  st.50 = 値  /  値 = st.50   (lpoke/lpeek も可)
; OutgoingBytes : DWORD (+204, 4byte)  st.51 = 値  /  値 = st.51   (lpoke/lpeek も可)
; IncomingFrames : DWORD (+208, 4byte)  st.52 = 値  /  値 = st.52   (lpoke/lpeek も可)
; OutgoingFrames : DWORD (+212, 4byte)  st.53 = 値  /  値 = st.53   (lpoke/lpeek も可)
; IncomingCompressedBytes : DWORD (+216, 4byte)  st.54 = 値  /  値 = st.54   (lpoke/lpeek も可)
; OutgoingCompressedBytes : DWORD (+220, 4byte)  st.55 = 値  /  値 = st.55   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global WTSINFOEX_LEVEL1_W
    #field int SessionId
    #field int SessionState
    #field int SessionFlags
    #field wchar WinStationName 33
    #field wchar UserName 21
    #field wchar DomainName 18
    #field int64 LogonTime
    #field int64 ConnectTime
    #field int64 DisconnectTime
    #field int64 LastInputTime
    #field int64 CurrentTime
    #field int IncomingBytes
    #field int OutgoingBytes
    #field int IncomingFrames
    #field int OutgoingFrames
    #field int IncomingCompressedBytes
    #field int OutgoingCompressedBytes
#endstruct

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