ホーム › Networking.WinSock › WSAConnect
WSAConnect
関数接続データやQoS指定付きで相手に接続する。
シグネチャ
// WS2_32.dll
#include <windows.h>
INT WSAConnect(
SOCKET s,
const SOCKADDR* name,
INT namelen,
WSABUF* lpCallerData, // optional
WSABUF* lpCalleeData, // optional
QOS* lpSQOS, // optional
QOS* lpGQOS // optional
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| s | SOCKET | in |
| name | SOCKADDR* | in |
| namelen | INT | in |
| lpCallerData | WSABUF* | inoptional |
| lpCalleeData | WSABUF* | outoptional |
| lpSQOS | QOS* | inoptional |
| lpGQOS | QOS* | inoptional |
戻り値の型: INT
各言語での呼び出し定義
// WS2_32.dll
#include <windows.h>
INT WSAConnect(
SOCKET s,
const SOCKADDR* name,
INT namelen,
WSABUF* lpCallerData, // optional
WSABUF* lpCalleeData, // optional
QOS* lpSQOS, // optional
QOS* lpGQOS // optional
);[DllImport("WS2_32.dll", SetLastError = true, ExactSpelling = true)]
static extern int WSAConnect(
UIntPtr s, // SOCKET
IntPtr name, // SOCKADDR*
int namelen, // INT
IntPtr lpCallerData, // WSABUF* optional
IntPtr lpCalleeData, // WSABUF* optional, out
IntPtr lpSQOS, // QOS* optional
IntPtr lpGQOS // QOS* optional
);<DllImport("WS2_32.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function WSAConnect(
s As UIntPtr, ' SOCKET
name As IntPtr, ' SOCKADDR*
namelen As Integer, ' INT
lpCallerData As IntPtr, ' WSABUF* optional
lpCalleeData As IntPtr, ' WSABUF* optional, out
lpSQOS As IntPtr, ' QOS* optional
lpGQOS As IntPtr ' QOS* optional
) As Integer
End Function' s : SOCKET
' name : SOCKADDR*
' namelen : INT
' lpCallerData : WSABUF* optional
' lpCalleeData : WSABUF* optional, out
' lpSQOS : QOS* optional
' lpGQOS : QOS* optional
Declare PtrSafe Function WSAConnect Lib "ws2_32" ( _
ByVal s As LongPtr, _
ByVal name As LongPtr, _
ByVal namelen As Long, _
ByVal lpCallerData As LongPtr, _
ByVal lpCalleeData As LongPtr, _
ByVal lpSQOS As LongPtr, _
ByVal lpGQOS As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
WSAConnect = ctypes.windll.ws2_32.WSAConnect
WSAConnect.restype = ctypes.c_int
WSAConnect.argtypes = [
ctypes.c_size_t, # s : SOCKET
ctypes.c_void_p, # name : SOCKADDR*
ctypes.c_int, # namelen : INT
ctypes.c_void_p, # lpCallerData : WSABUF* optional
ctypes.c_void_p, # lpCalleeData : WSABUF* optional, out
ctypes.c_void_p, # lpSQOS : QOS* optional
ctypes.c_void_p, # lpGQOS : QOS* optional
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('WS2_32.dll')
WSAConnect = Fiddle::Function.new(
lib['WSAConnect'],
[
Fiddle::TYPE_UINTPTR_T, # s : SOCKET
Fiddle::TYPE_VOIDP, # name : SOCKADDR*
Fiddle::TYPE_INT, # namelen : INT
Fiddle::TYPE_VOIDP, # lpCallerData : WSABUF* optional
Fiddle::TYPE_VOIDP, # lpCalleeData : WSABUF* optional, out
Fiddle::TYPE_VOIDP, # lpSQOS : QOS* optional
Fiddle::TYPE_VOIDP, # lpGQOS : QOS* optional
],
Fiddle::TYPE_INT)#[link(name = "ws2_32")]
extern "system" {
fn WSAConnect(
s: usize, // SOCKET
name: *const SOCKADDR, // SOCKADDR*
namelen: i32, // INT
lpCallerData: *mut WSABUF, // WSABUF* optional
lpCalleeData: *mut WSABUF, // WSABUF* optional, out
lpSQOS: *mut QOS, // QOS* optional
lpGQOS: *mut QOS // QOS* optional
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("WS2_32.dll", SetLastError = true)]
public static extern int WSAConnect(UIntPtr s, IntPtr name, int namelen, IntPtr lpCallerData, IntPtr lpCalleeData, IntPtr lpSQOS, IntPtr lpGQOS);
"@
$api = Add-Type -MemberDefinition $sig -Name 'WS2_32_WSAConnect' -Namespace Win32 -PassThru
# $api::WSAConnect(s, name, namelen, lpCallerData, lpCalleeData, lpSQOS, lpGQOS)#uselib "WS2_32.dll"
#func global WSAConnect "WSAConnect" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; WSAConnect s, varptr(name), namelen, varptr(lpCallerData), varptr(lpCalleeData), varptr(lpSQOS), varptr(lpGQOS) ; 戻り値は stat
; s : SOCKET -> "sptr"
; name : SOCKADDR* -> "sptr"
; namelen : INT -> "sptr"
; lpCallerData : WSABUF* optional -> "sptr"
; lpCalleeData : WSABUF* optional, out -> "sptr"
; lpSQOS : QOS* optional -> "sptr"
; lpGQOS : QOS* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "WS2_32.dll" #cfunc global WSAConnect "WSAConnect" sptr, var, int, var, var, var, var ; res = WSAConnect(s, name, namelen, lpCallerData, lpCalleeData, lpSQOS, lpGQOS) ; s : SOCKET -> "sptr" ; name : SOCKADDR* -> "var" ; namelen : INT -> "int" ; lpCallerData : WSABUF* optional -> "var" ; lpCalleeData : WSABUF* optional, out -> "var" ; lpSQOS : QOS* optional -> "var" ; lpGQOS : QOS* optional -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "WS2_32.dll" #cfunc global WSAConnect "WSAConnect" sptr, sptr, int, sptr, sptr, sptr, sptr ; res = WSAConnect(s, varptr(name), namelen, varptr(lpCallerData), varptr(lpCalleeData), varptr(lpSQOS), varptr(lpGQOS)) ; s : SOCKET -> "sptr" ; name : SOCKADDR* -> "sptr" ; namelen : INT -> "int" ; lpCallerData : WSABUF* optional -> "sptr" ; lpCalleeData : WSABUF* optional, out -> "sptr" ; lpSQOS : QOS* optional -> "sptr" ; lpGQOS : QOS* optional -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; INT WSAConnect(SOCKET s, SOCKADDR* name, INT namelen, WSABUF* lpCallerData, WSABUF* lpCalleeData, QOS* lpSQOS, QOS* lpGQOS) #uselib "WS2_32.dll" #cfunc global WSAConnect "WSAConnect" intptr, var, int, var, var, var, var ; res = WSAConnect(s, name, namelen, lpCallerData, lpCalleeData, lpSQOS, lpGQOS) ; s : SOCKET -> "intptr" ; name : SOCKADDR* -> "var" ; namelen : INT -> "int" ; lpCallerData : WSABUF* optional -> "var" ; lpCalleeData : WSABUF* optional, out -> "var" ; lpSQOS : QOS* optional -> "var" ; lpGQOS : QOS* optional -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; INT WSAConnect(SOCKET s, SOCKADDR* name, INT namelen, WSABUF* lpCallerData, WSABUF* lpCalleeData, QOS* lpSQOS, QOS* lpGQOS) #uselib "WS2_32.dll" #cfunc global WSAConnect "WSAConnect" intptr, intptr, int, intptr, intptr, intptr, intptr ; res = WSAConnect(s, varptr(name), namelen, varptr(lpCallerData), varptr(lpCalleeData), varptr(lpSQOS), varptr(lpGQOS)) ; s : SOCKET -> "intptr" ; name : SOCKADDR* -> "intptr" ; namelen : INT -> "int" ; lpCallerData : WSABUF* optional -> "intptr" ; lpCalleeData : WSABUF* optional, out -> "intptr" ; lpSQOS : QOS* optional -> "intptr" ; lpGQOS : QOS* optional -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
ws2_32 = windows.NewLazySystemDLL("WS2_32.dll")
procWSAConnect = ws2_32.NewProc("WSAConnect")
)
// s (SOCKET), name (SOCKADDR*), namelen (INT), lpCallerData (WSABUF* optional), lpCalleeData (WSABUF* optional, out), lpSQOS (QOS* optional), lpGQOS (QOS* optional)
r1, _, err := procWSAConnect.Call(
uintptr(s),
uintptr(name),
uintptr(namelen),
uintptr(lpCallerData),
uintptr(lpCalleeData),
uintptr(lpSQOS),
uintptr(lpGQOS),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // INTfunction WSAConnect(
s: NativeUInt; // SOCKET
name: Pointer; // SOCKADDR*
namelen: Integer; // INT
lpCallerData: Pointer; // WSABUF* optional
lpCalleeData: Pointer; // WSABUF* optional, out
lpSQOS: Pointer; // QOS* optional
lpGQOS: Pointer // QOS* optional
): Integer; stdcall;
external 'WS2_32.dll' name 'WSAConnect';result := DllCall("WS2_32\WSAConnect"
, "UPtr", s ; SOCKET
, "Ptr", name ; SOCKADDR*
, "Int", namelen ; INT
, "Ptr", lpCallerData ; WSABUF* optional
, "Ptr", lpCalleeData ; WSABUF* optional, out
, "Ptr", lpSQOS ; QOS* optional
, "Ptr", lpGQOS ; QOS* optional
, "Int") ; return: INT●WSAConnect(s, name, namelen, lpCallerData, lpCalleeData, lpSQOS, lpGQOS) = DLL("WS2_32.dll", "int WSAConnect(int, void*, int, void*, void*, void*, void*)")
# 呼び出し: WSAConnect(s, name, namelen, lpCallerData, lpCalleeData, lpSQOS, lpGQOS)
# s : SOCKET -> "int"
# name : SOCKADDR* -> "void*"
# namelen : INT -> "int"
# lpCallerData : WSABUF* optional -> "void*"
# lpCalleeData : WSABUF* optional, out -> "void*"
# lpSQOS : QOS* optional -> "void*"
# lpGQOS : QOS* optional -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。