ホーム › Networking.WinHttp › WinHttpWebSocketQueryCloseStatus
WinHttpWebSocketQueryCloseStatus
関数WebSocketの切断ステータスと理由を取得する。
シグネチャ
// WINHTTP.dll
#include <windows.h>
DWORD WinHttpWebSocketQueryCloseStatus(
void* hWebSocket,
WORD* pusStatus,
void* pvReason, // optional
DWORD dwReasonLength,
DWORD* pdwReasonLengthConsumed
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| hWebSocket | void* | in |
| pusStatus | WORD* | out |
| pvReason | void* | outoptional |
| dwReasonLength | DWORD | in |
| pdwReasonLengthConsumed | DWORD* | inout |
戻り値の型: DWORD
各言語での呼び出し定義
// WINHTTP.dll
#include <windows.h>
DWORD WinHttpWebSocketQueryCloseStatus(
void* hWebSocket,
WORD* pusStatus,
void* pvReason, // optional
DWORD dwReasonLength,
DWORD* pdwReasonLengthConsumed
);[DllImport("WINHTTP.dll", ExactSpelling = true)]
static extern uint WinHttpWebSocketQueryCloseStatus(
IntPtr hWebSocket, // void*
out ushort pusStatus, // WORD* out
IntPtr pvReason, // void* optional, out
uint dwReasonLength, // DWORD
ref uint pdwReasonLengthConsumed // DWORD* in/out
);<DllImport("WINHTTP.dll", ExactSpelling:=True)>
Public Shared Function WinHttpWebSocketQueryCloseStatus(
hWebSocket As IntPtr, ' void*
<Out> ByRef pusStatus As UShort, ' WORD* out
pvReason As IntPtr, ' void* optional, out
dwReasonLength As UInteger, ' DWORD
ByRef pdwReasonLengthConsumed As UInteger ' DWORD* in/out
) As UInteger
End Function' hWebSocket : void*
' pusStatus : WORD* out
' pvReason : void* optional, out
' dwReasonLength : DWORD
' pdwReasonLengthConsumed : DWORD* in/out
Declare PtrSafe Function WinHttpWebSocketQueryCloseStatus Lib "winhttp" ( _
ByVal hWebSocket As LongPtr, _
ByRef pusStatus As Integer, _
ByVal pvReason As LongPtr, _
ByVal dwReasonLength As Long, _
ByRef pdwReasonLengthConsumed As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
WinHttpWebSocketQueryCloseStatus = ctypes.windll.winhttp.WinHttpWebSocketQueryCloseStatus
WinHttpWebSocketQueryCloseStatus.restype = wintypes.DWORD
WinHttpWebSocketQueryCloseStatus.argtypes = [
ctypes.POINTER(None), # hWebSocket : void*
ctypes.POINTER(ctypes.c_ushort), # pusStatus : WORD* out
ctypes.POINTER(None), # pvReason : void* optional, out
wintypes.DWORD, # dwReasonLength : DWORD
ctypes.POINTER(wintypes.DWORD), # pdwReasonLengthConsumed : DWORD* in/out
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('WINHTTP.dll')
WinHttpWebSocketQueryCloseStatus = Fiddle::Function.new(
lib['WinHttpWebSocketQueryCloseStatus'],
[
Fiddle::TYPE_VOIDP, # hWebSocket : void*
Fiddle::TYPE_VOIDP, # pusStatus : WORD* out
Fiddle::TYPE_VOIDP, # pvReason : void* optional, out
-Fiddle::TYPE_INT, # dwReasonLength : DWORD
Fiddle::TYPE_VOIDP, # pdwReasonLengthConsumed : DWORD* in/out
],
-Fiddle::TYPE_INT)#[link(name = "winhttp")]
extern "system" {
fn WinHttpWebSocketQueryCloseStatus(
hWebSocket: *mut (), // void*
pusStatus: *mut u16, // WORD* out
pvReason: *mut (), // void* optional, out
dwReasonLength: u32, // DWORD
pdwReasonLengthConsumed: *mut u32 // DWORD* in/out
) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("WINHTTP.dll")]
public static extern uint WinHttpWebSocketQueryCloseStatus(IntPtr hWebSocket, out ushort pusStatus, IntPtr pvReason, uint dwReasonLength, ref uint pdwReasonLengthConsumed);
"@
$api = Add-Type -MemberDefinition $sig -Name 'WINHTTP_WinHttpWebSocketQueryCloseStatus' -Namespace Win32 -PassThru
# $api::WinHttpWebSocketQueryCloseStatus(hWebSocket, pusStatus, pvReason, dwReasonLength, pdwReasonLengthConsumed)#uselib "WINHTTP.dll"
#func global WinHttpWebSocketQueryCloseStatus "WinHttpWebSocketQueryCloseStatus" sptr, sptr, sptr, sptr, sptr
; WinHttpWebSocketQueryCloseStatus hWebSocket, varptr(pusStatus), pvReason, dwReasonLength, varptr(pdwReasonLengthConsumed) ; 戻り値は stat
; hWebSocket : void* -> "sptr"
; pusStatus : WORD* out -> "sptr"
; pvReason : void* optional, out -> "sptr"
; dwReasonLength : DWORD -> "sptr"
; pdwReasonLengthConsumed : DWORD* in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "WINHTTP.dll" #cfunc global WinHttpWebSocketQueryCloseStatus "WinHttpWebSocketQueryCloseStatus" sptr, var, sptr, int, var ; res = WinHttpWebSocketQueryCloseStatus(hWebSocket, pusStatus, pvReason, dwReasonLength, pdwReasonLengthConsumed) ; hWebSocket : void* -> "sptr" ; pusStatus : WORD* out -> "var" ; pvReason : void* optional, out -> "sptr" ; dwReasonLength : DWORD -> "int" ; pdwReasonLengthConsumed : DWORD* in/out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "WINHTTP.dll" #cfunc global WinHttpWebSocketQueryCloseStatus "WinHttpWebSocketQueryCloseStatus" sptr, sptr, sptr, int, sptr ; res = WinHttpWebSocketQueryCloseStatus(hWebSocket, varptr(pusStatus), pvReason, dwReasonLength, varptr(pdwReasonLengthConsumed)) ; hWebSocket : void* -> "sptr" ; pusStatus : WORD* out -> "sptr" ; pvReason : void* optional, out -> "sptr" ; dwReasonLength : DWORD -> "int" ; pdwReasonLengthConsumed : DWORD* in/out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; DWORD WinHttpWebSocketQueryCloseStatus(void* hWebSocket, WORD* pusStatus, void* pvReason, DWORD dwReasonLength, DWORD* pdwReasonLengthConsumed) #uselib "WINHTTP.dll" #cfunc global WinHttpWebSocketQueryCloseStatus "WinHttpWebSocketQueryCloseStatus" intptr, var, intptr, int, var ; res = WinHttpWebSocketQueryCloseStatus(hWebSocket, pusStatus, pvReason, dwReasonLength, pdwReasonLengthConsumed) ; hWebSocket : void* -> "intptr" ; pusStatus : WORD* out -> "var" ; pvReason : void* optional, out -> "intptr" ; dwReasonLength : DWORD -> "int" ; pdwReasonLengthConsumed : DWORD* in/out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; DWORD WinHttpWebSocketQueryCloseStatus(void* hWebSocket, WORD* pusStatus, void* pvReason, DWORD dwReasonLength, DWORD* pdwReasonLengthConsumed) #uselib "WINHTTP.dll" #cfunc global WinHttpWebSocketQueryCloseStatus "WinHttpWebSocketQueryCloseStatus" intptr, intptr, intptr, int, intptr ; res = WinHttpWebSocketQueryCloseStatus(hWebSocket, varptr(pusStatus), pvReason, dwReasonLength, varptr(pdwReasonLengthConsumed)) ; hWebSocket : void* -> "intptr" ; pusStatus : WORD* out -> "intptr" ; pvReason : void* optional, out -> "intptr" ; dwReasonLength : DWORD -> "int" ; pdwReasonLengthConsumed : DWORD* in/out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
winhttp = windows.NewLazySystemDLL("WINHTTP.dll")
procWinHttpWebSocketQueryCloseStatus = winhttp.NewProc("WinHttpWebSocketQueryCloseStatus")
)
// hWebSocket (void*), pusStatus (WORD* out), pvReason (void* optional, out), dwReasonLength (DWORD), pdwReasonLengthConsumed (DWORD* in/out)
r1, _, err := procWinHttpWebSocketQueryCloseStatus.Call(
uintptr(hWebSocket),
uintptr(pusStatus),
uintptr(pvReason),
uintptr(dwReasonLength),
uintptr(pdwReasonLengthConsumed),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // DWORDfunction WinHttpWebSocketQueryCloseStatus(
hWebSocket: Pointer; // void*
pusStatus: Pointer; // WORD* out
pvReason: Pointer; // void* optional, out
dwReasonLength: DWORD; // DWORD
pdwReasonLengthConsumed: Pointer // DWORD* in/out
): DWORD; stdcall;
external 'WINHTTP.dll' name 'WinHttpWebSocketQueryCloseStatus';result := DllCall("WINHTTP\WinHttpWebSocketQueryCloseStatus"
, "Ptr", hWebSocket ; void*
, "Ptr", pusStatus ; WORD* out
, "Ptr", pvReason ; void* optional, out
, "UInt", dwReasonLength ; DWORD
, "Ptr", pdwReasonLengthConsumed ; DWORD* in/out
, "UInt") ; return: DWORD●WinHttpWebSocketQueryCloseStatus(hWebSocket, pusStatus, pvReason, dwReasonLength, pdwReasonLengthConsumed) = DLL("WINHTTP.dll", "dword WinHttpWebSocketQueryCloseStatus(void*, void*, void*, dword, void*)")
# 呼び出し: WinHttpWebSocketQueryCloseStatus(hWebSocket, pusStatus, pvReason, dwReasonLength, pdwReasonLengthConsumed)
# hWebSocket : void* -> "void*"
# pusStatus : WORD* out -> "void*"
# pvReason : void* optional, out -> "void*"
# dwReasonLength : DWORD -> "dword"
# pdwReasonLengthConsumed : DWORD* in/out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。