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

ISCSI_SESSION_INFOA

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

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

フィールド

フィールド型サイズx64x86説明
SessionIdISCSI_UNIQUE_SESSION_ID16+0+0このセッションを一意に識別するISCSI_UNIQUE_SESSION_ID。
InitiatorNameLPSTR8/4+16+16イニシエータ名(iSCSI修飾名)文字列へのポインタ(ANSI)。
TargetNodeNameLPSTR8/4+24+20ターゲットノード名文字列へのポインタ(ANSI)。
TargetNameLPSTR8/4+32+24接続先ターゲット名文字列へのポインタ(ANSI)。
ISIDBYTE6+40+28イニシエータ側セッション識別子(ISID)を表す6バイト配列。
TSIDBYTE2+46+34ターゲット側セッション識別子(TSID)を表す2バイト配列。
ConnectionCountDWORD4+48+36Connectionsが指す接続情報配列の要素数。
ConnectionsISCSI_CONNECTION_INFOA*8/4+56+40このセッションに属する各接続情報を並べたISCSI_CONNECTION_INFOA配列へのポインタ。

各言語での定義

#include <windows.h>

// ISCSI_UNIQUE_SESSION_ID  (x64 16 / x86 16 バイト)
typedef struct ISCSI_UNIQUE_SESSION_ID {
    ULONGLONG AdapterUnique;
    ULONGLONG AdapterSpecific;
} ISCSI_UNIQUE_SESSION_ID;

// ISCSI_SESSION_INFOA  (x64 64 / x86 48 バイト)
typedef struct ISCSI_SESSION_INFOA {
    ISCSI_UNIQUE_SESSION_ID SessionId;
    LPSTR InitiatorName;
    LPSTR TargetNodeName;
    LPSTR TargetName;
    BYTE ISID[6];
    BYTE TSID[2];
    DWORD ConnectionCount;
    ISCSI_CONNECTION_INFOA* Connections;
} ISCSI_SESSION_INFOA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ISCSI_UNIQUE_SESSION_ID
{
    public ulong AdapterUnique;
    public ulong AdapterSpecific;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ISCSI_SESSION_INFOA
{
    public ISCSI_UNIQUE_SESSION_ID SessionId;
    public IntPtr InitiatorName;
    public IntPtr TargetNodeName;
    public IntPtr TargetName;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 6)] public byte[] ISID;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 2)] public byte[] TSID;
    public uint ConnectionCount;
    public IntPtr Connections;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ISCSI_UNIQUE_SESSION_ID
    Public AdapterUnique As ULong
    Public AdapterSpecific As ULong
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ISCSI_SESSION_INFOA
    Public SessionId As ISCSI_UNIQUE_SESSION_ID
    Public InitiatorName As IntPtr
    Public TargetNodeName As IntPtr
    Public TargetName As IntPtr
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=6)> Public ISID() As Byte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=2)> Public TSID() As Byte
    Public ConnectionCount As UInteger
    Public Connections As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class ISCSI_UNIQUE_SESSION_ID(ctypes.Structure):
    _fields_ = [
        ("AdapterUnique", ctypes.c_ulonglong),
        ("AdapterSpecific", ctypes.c_ulonglong),
    ]

class ISCSI_SESSION_INFOA(ctypes.Structure):
    _fields_ = [
        ("SessionId", ISCSI_UNIQUE_SESSION_ID),
        ("InitiatorName", ctypes.c_void_p),
        ("TargetNodeName", ctypes.c_void_p),
        ("TargetName", ctypes.c_void_p),
        ("ISID", ctypes.c_ubyte * 6),
        ("TSID", ctypes.c_ubyte * 2),
        ("ConnectionCount", wintypes.DWORD),
        ("Connections", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct ISCSI_UNIQUE_SESSION_ID {
    pub AdapterUnique: u64,
    pub AdapterSpecific: u64,
}

#[repr(C)]
pub struct ISCSI_SESSION_INFOA {
    pub SessionId: ISCSI_UNIQUE_SESSION_ID,
    pub InitiatorName: *mut core::ffi::c_void,
    pub TargetNodeName: *mut core::ffi::c_void,
    pub TargetName: *mut core::ffi::c_void,
    pub ISID: [u8; 6],
    pub TSID: [u8; 2],
    pub ConnectionCount: u32,
    pub Connections: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type ISCSI_UNIQUE_SESSION_ID struct {
	AdapterUnique uint64
	AdapterSpecific uint64
}

type ISCSI_SESSION_INFOA struct {
	SessionId ISCSI_UNIQUE_SESSION_ID
	InitiatorName uintptr
	TargetNodeName uintptr
	TargetName uintptr
	ISID [6]byte
	TSID [2]byte
	ConnectionCount uint32
	Connections uintptr
}
type
  ISCSI_UNIQUE_SESSION_ID = record
    AdapterUnique: UInt64;
    AdapterSpecific: UInt64;
  end;

  ISCSI_SESSION_INFOA = record
    SessionId: ISCSI_UNIQUE_SESSION_ID;
    InitiatorName: Pointer;
    TargetNodeName: Pointer;
    TargetName: Pointer;
    ISID: array[0..5] of Byte;
    TSID: array[0..1] of Byte;
    ConnectionCount: DWORD;
    Connections: Pointer;
  end;
const ISCSI_UNIQUE_SESSION_ID = extern struct {
    AdapterUnique: u64,
    AdapterSpecific: u64,
};

const ISCSI_SESSION_INFOA = extern struct {
    SessionId: ISCSI_UNIQUE_SESSION_ID,
    InitiatorName: ?*anyopaque,
    TargetNodeName: ?*anyopaque,
    TargetName: ?*anyopaque,
    ISID: [6]u8,
    TSID: [2]u8,
    ConnectionCount: u32,
    Connections: ?*anyopaque,
};
type
  ISCSI_UNIQUE_SESSION_ID {.bycopy.} = object
    AdapterUnique: uint64
    AdapterSpecific: uint64

  ISCSI_SESSION_INFOA {.bycopy.} = object
    SessionId: ISCSI_UNIQUE_SESSION_ID
    InitiatorName: pointer
    TargetNodeName: pointer
    TargetName: pointer
    ISID: array[6, uint8]
    TSID: array[2, uint8]
    ConnectionCount: uint32
    Connections: pointer
struct ISCSI_UNIQUE_SESSION_ID
{
    ulong AdapterUnique;
    ulong AdapterSpecific;
}

struct ISCSI_SESSION_INFOA
{
    ISCSI_UNIQUE_SESSION_ID SessionId;
    void* InitiatorName;
    void* TargetNodeName;
    void* TargetName;
    ubyte[6] ISID;
    ubyte[2] TSID;
    uint ConnectionCount;
    void* Connections;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; ISCSI_SESSION_INFOA サイズ: 48 バイト(x86)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; SessionId : ISCSI_UNIQUE_SESSION_ID (+0, 16byte)  varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; InitiatorName : LPSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; TargetNodeName : LPSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; TargetName : LPSTR (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ISID : BYTE (+28, 6byte)  varptr(st)+28 を基点に操作(6byte:入れ子/配列)
; TSID : BYTE (+34, 2byte)  varptr(st)+34 を基点に操作(2byte:入れ子/配列)
; ConnectionCount : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; Connections : ISCSI_CONNECTION_INFOA* (+40, 4byte)  varptr(st)+40 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ISCSI_SESSION_INFOA サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; SessionId : ISCSI_UNIQUE_SESSION_ID (+0, 16byte)  varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; InitiatorName : LPSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; TargetNodeName : LPSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; TargetName : LPSTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; ISID : BYTE (+40, 6byte)  varptr(st)+40 を基点に操作(6byte:入れ子/配列)
; TSID : BYTE (+46, 2byte)  varptr(st)+46 を基点に操作(2byte:入れ子/配列)
; ConnectionCount : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; Connections : ISCSI_CONNECTION_INFOA* (+56, 8byte)  varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global ISCSI_UNIQUE_SESSION_ID
    #field int64 AdapterUnique
    #field int64 AdapterSpecific
#endstruct

#defstruct global ISCSI_SESSION_INFOA
    #field ISCSI_UNIQUE_SESSION_ID SessionId
    #field intptr InitiatorName
    #field intptr TargetNodeName
    #field intptr TargetName
    #field byte ISID 6
    #field byte TSID 2
    #field int ConnectionCount
    #field intptr Connections
#endstruct

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