ホーム › Storage.IscsiDisc › AddIScsiConnectionA

AddIScsiConnectionA

関数

既存のiSCSIセッションに新しい接続を追加する（ANSI版）。

DLLISCSIDSC.dll文字セットANSI (-A)呼出規約winapi対応OSWindows Vista 以降

シグネチャ

// ISCSIDSC.dll  (ANSI / -A)
#include <windows.h>

DWORD AddIScsiConnectionA(
    ISCSI_UNIQUE_SESSION_ID* UniqueSessionId,
    void* Reserved,
    DWORD InitiatorPortNumber,
    ISCSI_TARGET_PORTALA* TargetPortal,
    ULONGLONG SecurityFlags,
    ISCSI_LOGIN_OPTIONS* LoginOptions,
    DWORD KeySize,
    LPSTR Key,   // optional
    ISCSI_UNIQUE_SESSION_ID* ConnectionId
);

パラメーター

名前	型	方向
UniqueSessionId	ISCSI_UNIQUE_SESSION_ID*	inout
Reserved	void*	inout
InitiatorPortNumber	DWORD	in
TargetPortal	ISCSI_TARGET_PORTALA*	inout
SecurityFlags	ULONGLONG	in
LoginOptions	ISCSI_LOGIN_OPTIONS*	inout
KeySize	DWORD	in
Key	LPSTR	inoptional
ConnectionId	ISCSI_UNIQUE_SESSION_ID*	inout

戻り値の型: DWORD

各言語での呼び出し定義

// ISCSIDSC.dll  (ANSI / -A)
#include <windows.h>

DWORD AddIScsiConnectionA(
    ISCSI_UNIQUE_SESSION_ID* UniqueSessionId,
    void* Reserved,
    DWORD InitiatorPortNumber,
    ISCSI_TARGET_PORTALA* TargetPortal,
    ULONGLONG SecurityFlags,
    ISCSI_LOGIN_OPTIONS* LoginOptions,
    DWORD KeySize,
    LPSTR Key,   // optional
    ISCSI_UNIQUE_SESSION_ID* ConnectionId
);

[DllImport("ISCSIDSC.dll", CharSet = CharSet.Ansi, ExactSpelling = true)]
static extern uint AddIScsiConnectionA(
    IntPtr UniqueSessionId,   // ISCSI_UNIQUE_SESSION_ID* in/out
    IntPtr Reserved,   // void* in/out
    uint InitiatorPortNumber,   // DWORD
    IntPtr TargetPortal,   // ISCSI_TARGET_PORTALA* in/out
    ulong SecurityFlags,   // ULONGLONG
    IntPtr LoginOptions,   // ISCSI_LOGIN_OPTIONS* in/out
    uint KeySize,   // DWORD
    [MarshalAs(UnmanagedType.LPStr)] string Key,   // LPSTR optional
    IntPtr ConnectionId   // ISCSI_UNIQUE_SESSION_ID* in/out
);

<DllImport("ISCSIDSC.dll", CharSet:=CharSet.Ansi, ExactSpelling:=True)>
Public Shared Function AddIScsiConnectionA(
    UniqueSessionId As IntPtr,   ' ISCSI_UNIQUE_SESSION_ID* in/out
    Reserved As IntPtr,   ' void* in/out
    InitiatorPortNumber As UInteger,   ' DWORD
    TargetPortal As IntPtr,   ' ISCSI_TARGET_PORTALA* in/out
    SecurityFlags As ULong,   ' ULONGLONG
    LoginOptions As IntPtr,   ' ISCSI_LOGIN_OPTIONS* in/out
    KeySize As UInteger,   ' DWORD
    <MarshalAs(UnmanagedType.LPStr)> Key As String,   ' LPSTR optional
    ConnectionId As IntPtr   ' ISCSI_UNIQUE_SESSION_ID* in/out
) As UInteger
End Function

' UniqueSessionId : ISCSI_UNIQUE_SESSION_ID* in/out
' Reserved : void* in/out
' InitiatorPortNumber : DWORD
' TargetPortal : ISCSI_TARGET_PORTALA* in/out
' SecurityFlags : ULONGLONG
' LoginOptions : ISCSI_LOGIN_OPTIONS* in/out
' KeySize : DWORD
' Key : LPSTR optional
' ConnectionId : ISCSI_UNIQUE_SESSION_ID* in/out
Declare PtrSafe Function AddIScsiConnectionA Lib "iscsidsc" ( _
    ByVal UniqueSessionId As LongPtr, _
    ByVal Reserved As LongPtr, _
    ByVal InitiatorPortNumber As Long, _
    ByVal TargetPortal As LongPtr, _
    ByVal SecurityFlags As LongLong, _
    ByVal LoginOptions As LongPtr, _
    ByVal KeySize As Long, _
    ByVal Key As String, _
    ByVal ConnectionId As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

AddIScsiConnectionA = ctypes.windll.iscsidsc.AddIScsiConnectionA
AddIScsiConnectionA.restype = wintypes.DWORD
AddIScsiConnectionA.argtypes = [
    ctypes.c_void_p,  # UniqueSessionId : ISCSI_UNIQUE_SESSION_ID* in/out
    ctypes.POINTER(None),  # Reserved : void* in/out
    wintypes.DWORD,  # InitiatorPortNumber : DWORD
    ctypes.c_void_p,  # TargetPortal : ISCSI_TARGET_PORTALA* in/out
    ctypes.c_ulonglong,  # SecurityFlags : ULONGLONG
    ctypes.c_void_p,  # LoginOptions : ISCSI_LOGIN_OPTIONS* in/out
    wintypes.DWORD,  # KeySize : DWORD
    wintypes.LPCSTR,  # Key : LPSTR optional
    ctypes.c_void_p,  # ConnectionId : ISCSI_UNIQUE_SESSION_ID* in/out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ISCSIDSC.dll')
AddIScsiConnectionA = Fiddle::Function.new(
  lib['AddIScsiConnectionA'],
  [
    Fiddle::TYPE_VOIDP,  # UniqueSessionId : ISCSI_UNIQUE_SESSION_ID* in/out
    Fiddle::TYPE_VOIDP,  # Reserved : void* in/out
    -Fiddle::TYPE_INT,  # InitiatorPortNumber : DWORD
    Fiddle::TYPE_VOIDP,  # TargetPortal : ISCSI_TARGET_PORTALA* in/out
    -Fiddle::TYPE_LONG_LONG,  # SecurityFlags : ULONGLONG
    Fiddle::TYPE_VOIDP,  # LoginOptions : ISCSI_LOGIN_OPTIONS* in/out
    -Fiddle::TYPE_INT,  # KeySize : DWORD
    Fiddle::TYPE_VOIDP,  # Key : LPSTR optional
    Fiddle::TYPE_VOIDP,  # ConnectionId : ISCSI_UNIQUE_SESSION_ID* in/out
  ],
  -Fiddle::TYPE_INT)

#[link(name = "iscsidsc")]
extern "system" {
    fn AddIScsiConnectionA(
        UniqueSessionId: *mut ISCSI_UNIQUE_SESSION_ID,  // ISCSI_UNIQUE_SESSION_ID* in/out
        Reserved: *mut (),  // void* in/out
        InitiatorPortNumber: u32,  // DWORD
        TargetPortal: *mut ISCSI_TARGET_PORTALA,  // ISCSI_TARGET_PORTALA* in/out
        SecurityFlags: u64,  // ULONGLONG
        LoginOptions: *mut ISCSI_LOGIN_OPTIONS,  // ISCSI_LOGIN_OPTIONS* in/out
        KeySize: u32,  // DWORD
        Key: *mut u8,  // LPSTR optional
        ConnectionId: *mut ISCSI_UNIQUE_SESSION_ID  // ISCSI_UNIQUE_SESSION_ID* in/out
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("ISCSIDSC.dll", CharSet = CharSet.Ansi)]
public static extern uint AddIScsiConnectionA(IntPtr UniqueSessionId, IntPtr Reserved, uint InitiatorPortNumber, IntPtr TargetPortal, ulong SecurityFlags, IntPtr LoginOptions, uint KeySize, [MarshalAs(UnmanagedType.LPStr)] string Key, IntPtr ConnectionId);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ISCSIDSC_AddIScsiConnectionA' -Namespace Win32 -PassThru
# $api::AddIScsiConnectionA(UniqueSessionId, Reserved, InitiatorPortNumber, TargetPortal, SecurityFlags, LoginOptions, KeySize, Key, ConnectionId)

#uselib "ISCSIDSC.dll"
#func global AddIScsiConnectionA "AddIScsiConnectionA" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; AddIScsiConnectionA varptr(UniqueSessionId), Reserved, InitiatorPortNumber, varptr(TargetPortal), SecurityFlags, varptr(LoginOptions), KeySize, Key, varptr(ConnectionId)   ; 戻り値は stat
; UniqueSessionId : ISCSI_UNIQUE_SESSION_ID* in/out -> "sptr"
; Reserved : void* in/out -> "sptr"
; InitiatorPortNumber : DWORD -> "sptr"
; TargetPortal : ISCSI_TARGET_PORTALA* in/out -> "sptr"
; SecurityFlags : ULONGLONG -> "sptr"
; LoginOptions : ISCSI_LOGIN_OPTIONS* in/out -> "sptr"
; KeySize : DWORD -> "sptr"
; Key : LPSTR optional -> "sptr"
; ConnectionId : ISCSI_UNIQUE_SESSION_ID* in/out -> "sptr"
; ※HSP3.7は int64 引数(64bit値渡し)に非対応です。
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "ISCSIDSC.dll"
#cfunc global AddIScsiConnectionA "AddIScsiConnectionA" var, sptr, int, var, int64, var, int, str, var
; res = AddIScsiConnectionA(UniqueSessionId, Reserved, InitiatorPortNumber, TargetPortal, SecurityFlags, LoginOptions, KeySize, Key, ConnectionId)
; UniqueSessionId : ISCSI_UNIQUE_SESSION_ID* in/out -> "var"
; Reserved : void* in/out -> "sptr"
; InitiatorPortNumber : DWORD -> "int"
; TargetPortal : ISCSI_TARGET_PORTALA* in/out -> "var"
; SecurityFlags : ULONGLONG -> "int64"
; LoginOptions : ISCSI_LOGIN_OPTIONS* in/out -> "var"
; KeySize : DWORD -> "int"
; Key : LPSTR optional -> "str"
; ConnectionId : ISCSI_UNIQUE_SESSION_ID* in/out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
; ※int64 引数の DLL 値渡しは x64 ランタイム(hsp3_64)のみ対応(x86 は未対応)。#uselib "ISCSIDSC.dll"
#cfunc global AddIScsiConnectionA "AddIScsiConnectionA" sptr, sptr, int, sptr, int64, sptr, int, str, sptr
; res = AddIScsiConnectionA(varptr(UniqueSessionId), Reserved, InitiatorPortNumber, varptr(TargetPortal), SecurityFlags, varptr(LoginOptions), KeySize, Key, varptr(ConnectionId))
; UniqueSessionId : ISCSI_UNIQUE_SESSION_ID* in/out -> "sptr"
; Reserved : void* in/out -> "sptr"
; InitiatorPortNumber : DWORD -> "int"
; TargetPortal : ISCSI_TARGET_PORTALA* in/out -> "sptr"
; SecurityFlags : ULONGLONG -> "int64"
; LoginOptions : ISCSI_LOGIN_OPTIONS* in/out -> "sptr"
; KeySize : DWORD -> "int"
; Key : LPSTR optional -> "str"
; ConnectionId : ISCSI_UNIQUE_SESSION_ID* in/out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※int64 引数の DLL 値渡しは x64 ランタイム(hsp3_64)のみ対応(x86 は未対応)。

出力引数:

; DWORD AddIScsiConnectionA(ISCSI_UNIQUE_SESSION_ID* UniqueSessionId, void* Reserved, DWORD InitiatorPortNumber, ISCSI_TARGET_PORTALA* TargetPortal, ULONGLONG SecurityFlags, ISCSI_LOGIN_OPTIONS* LoginOptions, DWORD KeySize, LPSTR Key, ISCSI_UNIQUE_SESSION_ID* ConnectionId)
#uselib "ISCSIDSC.dll"
#cfunc global AddIScsiConnectionA "AddIScsiConnectionA" var, intptr, int, var, int64, var, int, str, var
; res = AddIScsiConnectionA(UniqueSessionId, Reserved, InitiatorPortNumber, TargetPortal, SecurityFlags, LoginOptions, KeySize, Key, ConnectionId)
; UniqueSessionId : ISCSI_UNIQUE_SESSION_ID* in/out -> "var"
; Reserved : void* in/out -> "intptr"
; InitiatorPortNumber : DWORD -> "int"
; TargetPortal : ISCSI_TARGET_PORTALA* in/out -> "var"
; SecurityFlags : ULONGLONG -> "int64"
; LoginOptions : ISCSI_LOGIN_OPTIONS* in/out -> "var"
; KeySize : DWORD -> "int"
; Key : LPSTR optional -> "str"
; ConnectionId : ISCSI_UNIQUE_SESSION_ID* in/out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; DWORD AddIScsiConnectionA(ISCSI_UNIQUE_SESSION_ID* UniqueSessionId, void* Reserved, DWORD InitiatorPortNumber, ISCSI_TARGET_PORTALA* TargetPortal, ULONGLONG SecurityFlags, ISCSI_LOGIN_OPTIONS* LoginOptions, DWORD KeySize, LPSTR Key, ISCSI_UNIQUE_SESSION_ID* ConnectionId)
#uselib "ISCSIDSC.dll"
#cfunc global AddIScsiConnectionA "AddIScsiConnectionA" intptr, intptr, int, intptr, int64, intptr, int, str, intptr
; res = AddIScsiConnectionA(varptr(UniqueSessionId), Reserved, InitiatorPortNumber, varptr(TargetPortal), SecurityFlags, varptr(LoginOptions), KeySize, Key, varptr(ConnectionId))
; UniqueSessionId : ISCSI_UNIQUE_SESSION_ID* in/out -> "intptr"
; Reserved : void* in/out -> "intptr"
; InitiatorPortNumber : DWORD -> "int"
; TargetPortal : ISCSI_TARGET_PORTALA* in/out -> "intptr"
; SecurityFlags : ULONGLONG -> "int64"
; LoginOptions : ISCSI_LOGIN_OPTIONS* in/out -> "intptr"
; KeySize : DWORD -> "int"
; Key : LPSTR optional -> "str"
; ConnectionId : ISCSI_UNIQUE_SESSION_ID* in/out -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	iscsidsc = windows.NewLazySystemDLL("ISCSIDSC.dll")
	procAddIScsiConnectionA = iscsidsc.NewProc("AddIScsiConnectionA")
)

// UniqueSessionId (ISCSI_UNIQUE_SESSION_ID* in/out), Reserved (void* in/out), InitiatorPortNumber (DWORD), TargetPortal (ISCSI_TARGET_PORTALA* in/out), SecurityFlags (ULONGLONG), LoginOptions (ISCSI_LOGIN_OPTIONS* in/out), KeySize (DWORD), Key (LPSTR optional), ConnectionId (ISCSI_UNIQUE_SESSION_ID* in/out)
r1, _, err := procAddIScsiConnectionA.Call(
	uintptr(UniqueSessionId),
	uintptr(Reserved),
	uintptr(InitiatorPortNumber),
	uintptr(TargetPortal),
	uintptr(SecurityFlags),
	uintptr(LoginOptions),
	uintptr(KeySize),
	uintptr(unsafe.Pointer(windows.BytePtrFromString(Key))),
	uintptr(ConnectionId),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD

function AddIScsiConnectionA(
  UniqueSessionId: Pointer;   // ISCSI_UNIQUE_SESSION_ID* in/out
  Reserved: Pointer;   // void* in/out
  InitiatorPortNumber: DWORD;   // DWORD
  TargetPortal: Pointer;   // ISCSI_TARGET_PORTALA* in/out
  SecurityFlags: UInt64;   // ULONGLONG
  LoginOptions: Pointer;   // ISCSI_LOGIN_OPTIONS* in/out
  KeySize: DWORD;   // DWORD
  Key: PAnsiChar;   // LPSTR optional
  ConnectionId: Pointer   // ISCSI_UNIQUE_SESSION_ID* in/out
): DWORD; stdcall;
  external 'ISCSIDSC.dll' name 'AddIScsiConnectionA';

result := DllCall("ISCSIDSC\AddIScsiConnectionA"
    , "Ptr", UniqueSessionId   ; ISCSI_UNIQUE_SESSION_ID* in/out
    , "Ptr", Reserved   ; void* in/out
    , "UInt", InitiatorPortNumber   ; DWORD
    , "Ptr", TargetPortal   ; ISCSI_TARGET_PORTALA* in/out
    , "Int64", SecurityFlags   ; ULONGLONG
    , "Ptr", LoginOptions   ; ISCSI_LOGIN_OPTIONS* in/out
    , "UInt", KeySize   ; DWORD
    , "AStr", Key   ; LPSTR optional
    , "Ptr", ConnectionId   ; ISCSI_UNIQUE_SESSION_ID* in/out
    , "UInt")   ; return: DWORD

●AddIScsiConnectionA(UniqueSessionId, Reserved, InitiatorPortNumber, TargetPortal, SecurityFlags, LoginOptions, KeySize, Key, ConnectionId) = DLL("ISCSIDSC.dll", "dword AddIScsiConnectionA(void*, void*, dword, void*, qword, void*, dword, char*, void*)")
# 呼び出し: AddIScsiConnectionA(UniqueSessionId, Reserved, InitiatorPortNumber, TargetPortal, SecurityFlags, LoginOptions, KeySize, Key, ConnectionId)
# UniqueSessionId : ISCSI_UNIQUE_SESSION_ID* in/out -> "void*"
# Reserved : void* in/out -> "void*"
# InitiatorPortNumber : DWORD -> "dword"
# TargetPortal : ISCSI_TARGET_PORTALA* in/out -> "void*"
# SecurityFlags : ULONGLONG -> "qword"
# LoginOptions : ISCSI_LOGIN_OPTIONS* in/out -> "void*"
# KeySize : DWORD -> "dword"
# Key : LPSTR optional -> "char*"
# ConnectionId : ISCSI_UNIQUE_SESSION_ID* in/out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。