ホーム › System.RemoteManagement › WSManCloseShell

WSManCloseShell

関数

リモートシェルを閉じて解放する。

DLLWsmSvc.dll呼出規約winapi対応OSWindows 7 以降

シグネチャ

// WsmSvc.dll
#include <windows.h>

void WSManCloseShell(
    WSMAN_SHELL_HANDLE shellHandle,   // optional
    DWORD flags,
    WSMAN_SHELL_ASYNC* async
);

パラメーター

名前	型	方向
shellHandle	WSMAN_SHELL_HANDLE	inoptional
flags	DWORD	in
async	WSMAN_SHELL_ASYNC*	in

戻り値の型: void

各言語での呼び出し定義

// WsmSvc.dll
#include <windows.h>

void WSManCloseShell(
    WSMAN_SHELL_HANDLE shellHandle,   // optional
    DWORD flags,
    WSMAN_SHELL_ASYNC* async
);

[DllImport("WsmSvc.dll", ExactSpelling = true)]
static extern void WSManCloseShell(
    IntPtr shellHandle,   // WSMAN_SHELL_HANDLE optional
    uint flags,   // DWORD
    IntPtr async   // WSMAN_SHELL_ASYNC*
);

<DllImport("WsmSvc.dll", ExactSpelling:=True)>
Public Shared Sub WSManCloseShell(
    shellHandle As IntPtr,   ' WSMAN_SHELL_HANDLE optional
    flags As UInteger,   ' DWORD
    async As IntPtr   ' WSMAN_SHELL_ASYNC*
)
End Sub

' shellHandle : WSMAN_SHELL_HANDLE optional
' flags : DWORD
' async : WSMAN_SHELL_ASYNC*
Declare PtrSafe Sub WSManCloseShell Lib "wsmsvc" ( _
    ByVal shellHandle As LongPtr, _
    ByVal flags As Long, _
    ByVal async As LongPtr)
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

WSManCloseShell = ctypes.windll.wsmsvc.WSManCloseShell
WSManCloseShell.restype = None
WSManCloseShell.argtypes = [
    ctypes.c_ssize_t,  # shellHandle : WSMAN_SHELL_HANDLE optional
    wintypes.DWORD,  # flags : DWORD
    ctypes.c_void_p,  # async : WSMAN_SHELL_ASYNC*
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('WsmSvc.dll')
WSManCloseShell = Fiddle::Function.new(
  lib['WSManCloseShell'],
  [
    Fiddle::TYPE_INTPTR_T,  # shellHandle : WSMAN_SHELL_HANDLE optional
    -Fiddle::TYPE_INT,  # flags : DWORD
    Fiddle::TYPE_VOIDP,  # async : WSMAN_SHELL_ASYNC*
  ],
  Fiddle::TYPE_VOID)

#[link(name = "wsmsvc")]
extern "system" {
    fn WSManCloseShell(
        shellHandle: isize,  // WSMAN_SHELL_HANDLE optional
        flags: u32,  // DWORD
        async: *mut WSMAN_SHELL_ASYNC  // WSMAN_SHELL_ASYNC*
    );
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("WsmSvc.dll")]
public static extern void WSManCloseShell(IntPtr shellHandle, uint flags, IntPtr async);
"@
$api = Add-Type -MemberDefinition $sig -Name 'WsmSvc_WSManCloseShell' -Namespace Win32 -PassThru
# $api::WSManCloseShell(shellHandle, flags, async)

#uselib "WsmSvc.dll"
#func global WSManCloseShell "WSManCloseShell" sptr, sptr, sptr
; WSManCloseShell shellHandle, flags, varptr(async)
; shellHandle : WSMAN_SHELL_HANDLE optional -> "sptr"
; flags : DWORD -> "sptr"
; async : WSMAN_SHELL_ASYNC* -> "sptr"

出力引数:

#uselib "WsmSvc.dll"
#func global WSManCloseShell "WSManCloseShell" sptr, int, var
; WSManCloseShell shellHandle, flags, async
; shellHandle : WSMAN_SHELL_HANDLE optional -> "sptr"
; flags : DWORD -> "int"
; async : WSMAN_SHELL_ASYNC* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "WsmSvc.dll"
#func global WSManCloseShell "WSManCloseShell" sptr, int, sptr
; WSManCloseShell shellHandle, flags, varptr(async)
; shellHandle : WSMAN_SHELL_HANDLE optional -> "sptr"
; flags : DWORD -> "int"
; async : WSMAN_SHELL_ASYNC* -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; void WSManCloseShell(WSMAN_SHELL_HANDLE shellHandle, DWORD flags, WSMAN_SHELL_ASYNC* async)
#uselib "WsmSvc.dll"
#func global WSManCloseShell "WSManCloseShell" intptr, int, var
; WSManCloseShell shellHandle, flags, async
; shellHandle : WSMAN_SHELL_HANDLE optional -> "intptr"
; flags : DWORD -> "int"
; async : WSMAN_SHELL_ASYNC* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; void WSManCloseShell(WSMAN_SHELL_HANDLE shellHandle, DWORD flags, WSMAN_SHELL_ASYNC* async)
#uselib "WsmSvc.dll"
#func global WSManCloseShell "WSManCloseShell" intptr, int, intptr
; WSManCloseShell shellHandle, flags, varptr(async)
; shellHandle : WSMAN_SHELL_HANDLE optional -> "intptr"
; flags : DWORD -> "int"
; async : WSMAN_SHELL_ASYNC* -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

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

var (
	wsmsvc = windows.NewLazySystemDLL("WsmSvc.dll")
	procWSManCloseShell = wsmsvc.NewProc("WSManCloseShell")
)

// shellHandle (WSMAN_SHELL_HANDLE optional), flags (DWORD), async (WSMAN_SHELL_ASYNC*)
r1, _, err := procWSManCloseShell.Call(
	uintptr(shellHandle),
	uintptr(flags),
	uintptr(async),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // void

procedure WSManCloseShell(
  shellHandle: NativeInt;   // WSMAN_SHELL_HANDLE optional
  flags: DWORD;   // DWORD
  async: Pointer   // WSMAN_SHELL_ASYNC*
); stdcall;
  external 'WsmSvc.dll' name 'WSManCloseShell';

result := DllCall("WsmSvc\WSManCloseShell"
    , "Ptr", shellHandle   ; WSMAN_SHELL_HANDLE optional
    , "UInt", flags   ; DWORD
    , "Ptr", async   ; WSMAN_SHELL_ASYNC*
    , "Int")   ; return: void

●WSManCloseShell(shellHandle, flags, async) = DLL("WsmSvc.dll", "int WSManCloseShell(int, dword, void*)")
# 呼び出し: WSManCloseShell(shellHandle, flags, async)
# shellHandle : WSMAN_SHELL_HANDLE optional -> "int"
# flags : DWORD -> "dword"
# async : WSMAN_SHELL_ASYNC* -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。