ホーム › System.RestartManager › RmAddFilter
RmAddFilter
関数再起動対象から除外するフィルターを追加する。
シグネチャ
// RstrtMgr.dll
#include <windows.h>
WIN32_ERROR RmAddFilter(
DWORD dwSessionHandle,
LPCWSTR strModuleName, // optional
RM_UNIQUE_PROCESS* pProcess, // optional
LPCWSTR strServiceShortName, // optional
RM_FILTER_ACTION FilterAction
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| dwSessionHandle | DWORD | in |
| strModuleName | LPCWSTR | inoptional |
| pProcess | RM_UNIQUE_PROCESS* | inoptional |
| strServiceShortName | LPCWSTR | inoptional |
| FilterAction | RM_FILTER_ACTION | in |
戻り値の型: WIN32_ERROR
各言語での呼び出し定義
// RstrtMgr.dll
#include <windows.h>
WIN32_ERROR RmAddFilter(
DWORD dwSessionHandle,
LPCWSTR strModuleName, // optional
RM_UNIQUE_PROCESS* pProcess, // optional
LPCWSTR strServiceShortName, // optional
RM_FILTER_ACTION FilterAction
);[DllImport("RstrtMgr.dll", ExactSpelling = true)]
static extern uint RmAddFilter(
uint dwSessionHandle, // DWORD
[MarshalAs(UnmanagedType.LPWStr)] string strModuleName, // LPCWSTR optional
IntPtr pProcess, // RM_UNIQUE_PROCESS* optional
[MarshalAs(UnmanagedType.LPWStr)] string strServiceShortName, // LPCWSTR optional
int FilterAction // RM_FILTER_ACTION
);<DllImport("RstrtMgr.dll", ExactSpelling:=True)>
Public Shared Function RmAddFilter(
dwSessionHandle As UInteger, ' DWORD
<MarshalAs(UnmanagedType.LPWStr)> strModuleName As String, ' LPCWSTR optional
pProcess As IntPtr, ' RM_UNIQUE_PROCESS* optional
<MarshalAs(UnmanagedType.LPWStr)> strServiceShortName As String, ' LPCWSTR optional
FilterAction As Integer ' RM_FILTER_ACTION
) As UInteger
End Function' dwSessionHandle : DWORD
' strModuleName : LPCWSTR optional
' pProcess : RM_UNIQUE_PROCESS* optional
' strServiceShortName : LPCWSTR optional
' FilterAction : RM_FILTER_ACTION
Declare PtrSafe Function RmAddFilter Lib "rstrtmgr" ( _
ByVal dwSessionHandle As Long, _
ByVal strModuleName As LongPtr, _
ByVal pProcess As LongPtr, _
ByVal strServiceShortName As LongPtr, _
ByVal FilterAction As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
RmAddFilter = ctypes.windll.rstrtmgr.RmAddFilter
RmAddFilter.restype = wintypes.DWORD
RmAddFilter.argtypes = [
wintypes.DWORD, # dwSessionHandle : DWORD
wintypes.LPCWSTR, # strModuleName : LPCWSTR optional
ctypes.c_void_p, # pProcess : RM_UNIQUE_PROCESS* optional
wintypes.LPCWSTR, # strServiceShortName : LPCWSTR optional
ctypes.c_int, # FilterAction : RM_FILTER_ACTION
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('RstrtMgr.dll')
RmAddFilter = Fiddle::Function.new(
lib['RmAddFilter'],
[
-Fiddle::TYPE_INT, # dwSessionHandle : DWORD
Fiddle::TYPE_VOIDP, # strModuleName : LPCWSTR optional
Fiddle::TYPE_VOIDP, # pProcess : RM_UNIQUE_PROCESS* optional
Fiddle::TYPE_VOIDP, # strServiceShortName : LPCWSTR optional
Fiddle::TYPE_INT, # FilterAction : RM_FILTER_ACTION
],
-Fiddle::TYPE_INT)#[link(name = "rstrtmgr")]
extern "system" {
fn RmAddFilter(
dwSessionHandle: u32, // DWORD
strModuleName: *const u16, // LPCWSTR optional
pProcess: *mut RM_UNIQUE_PROCESS, // RM_UNIQUE_PROCESS* optional
strServiceShortName: *const u16, // LPCWSTR optional
FilterAction: i32 // RM_FILTER_ACTION
) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("RstrtMgr.dll")]
public static extern uint RmAddFilter(uint dwSessionHandle, [MarshalAs(UnmanagedType.LPWStr)] string strModuleName, IntPtr pProcess, [MarshalAs(UnmanagedType.LPWStr)] string strServiceShortName, int FilterAction);
"@
$api = Add-Type -MemberDefinition $sig -Name 'RstrtMgr_RmAddFilter' -Namespace Win32 -PassThru
# $api::RmAddFilter(dwSessionHandle, strModuleName, pProcess, strServiceShortName, FilterAction)#uselib "RstrtMgr.dll"
#func global RmAddFilter "RmAddFilter" sptr, sptr, sptr, sptr, sptr
; RmAddFilter dwSessionHandle, strModuleName, varptr(pProcess), strServiceShortName, FilterAction ; 戻り値は stat
; dwSessionHandle : DWORD -> "sptr"
; strModuleName : LPCWSTR optional -> "sptr"
; pProcess : RM_UNIQUE_PROCESS* optional -> "sptr"
; strServiceShortName : LPCWSTR optional -> "sptr"
; FilterAction : RM_FILTER_ACTION -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "RstrtMgr.dll" #cfunc global RmAddFilter "RmAddFilter" int, wstr, var, wstr, int ; res = RmAddFilter(dwSessionHandle, strModuleName, pProcess, strServiceShortName, FilterAction) ; dwSessionHandle : DWORD -> "int" ; strModuleName : LPCWSTR optional -> "wstr" ; pProcess : RM_UNIQUE_PROCESS* optional -> "var" ; strServiceShortName : LPCWSTR optional -> "wstr" ; FilterAction : RM_FILTER_ACTION -> "int" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "RstrtMgr.dll" #cfunc global RmAddFilter "RmAddFilter" int, wstr, sptr, wstr, int ; res = RmAddFilter(dwSessionHandle, strModuleName, varptr(pProcess), strServiceShortName, FilterAction) ; dwSessionHandle : DWORD -> "int" ; strModuleName : LPCWSTR optional -> "wstr" ; pProcess : RM_UNIQUE_PROCESS* optional -> "sptr" ; strServiceShortName : LPCWSTR optional -> "wstr" ; FilterAction : RM_FILTER_ACTION -> "int" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; WIN32_ERROR RmAddFilter(DWORD dwSessionHandle, LPCWSTR strModuleName, RM_UNIQUE_PROCESS* pProcess, LPCWSTR strServiceShortName, RM_FILTER_ACTION FilterAction) #uselib "RstrtMgr.dll" #cfunc global RmAddFilter "RmAddFilter" int, wstr, var, wstr, int ; res = RmAddFilter(dwSessionHandle, strModuleName, pProcess, strServiceShortName, FilterAction) ; dwSessionHandle : DWORD -> "int" ; strModuleName : LPCWSTR optional -> "wstr" ; pProcess : RM_UNIQUE_PROCESS* optional -> "var" ; strServiceShortName : LPCWSTR optional -> "wstr" ; FilterAction : RM_FILTER_ACTION -> "int" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; WIN32_ERROR RmAddFilter(DWORD dwSessionHandle, LPCWSTR strModuleName, RM_UNIQUE_PROCESS* pProcess, LPCWSTR strServiceShortName, RM_FILTER_ACTION FilterAction) #uselib "RstrtMgr.dll" #cfunc global RmAddFilter "RmAddFilter" int, wstr, intptr, wstr, int ; res = RmAddFilter(dwSessionHandle, strModuleName, varptr(pProcess), strServiceShortName, FilterAction) ; dwSessionHandle : DWORD -> "int" ; strModuleName : LPCWSTR optional -> "wstr" ; pProcess : RM_UNIQUE_PROCESS* optional -> "intptr" ; strServiceShortName : LPCWSTR optional -> "wstr" ; FilterAction : RM_FILTER_ACTION -> "int" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
rstrtmgr = windows.NewLazySystemDLL("RstrtMgr.dll")
procRmAddFilter = rstrtmgr.NewProc("RmAddFilter")
)
// dwSessionHandle (DWORD), strModuleName (LPCWSTR optional), pProcess (RM_UNIQUE_PROCESS* optional), strServiceShortName (LPCWSTR optional), FilterAction (RM_FILTER_ACTION)
r1, _, err := procRmAddFilter.Call(
uintptr(dwSessionHandle),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(strModuleName))),
uintptr(pProcess),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(strServiceShortName))),
uintptr(FilterAction),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // WIN32_ERRORfunction RmAddFilter(
dwSessionHandle: DWORD; // DWORD
strModuleName: PWideChar; // LPCWSTR optional
pProcess: Pointer; // RM_UNIQUE_PROCESS* optional
strServiceShortName: PWideChar; // LPCWSTR optional
FilterAction: Integer // RM_FILTER_ACTION
): DWORD; stdcall;
external 'RstrtMgr.dll' name 'RmAddFilter';result := DllCall("RstrtMgr\RmAddFilter"
, "UInt", dwSessionHandle ; DWORD
, "WStr", strModuleName ; LPCWSTR optional
, "Ptr", pProcess ; RM_UNIQUE_PROCESS* optional
, "WStr", strServiceShortName ; LPCWSTR optional
, "Int", FilterAction ; RM_FILTER_ACTION
, "UInt") ; return: WIN32_ERROR●RmAddFilter(dwSessionHandle, strModuleName, pProcess, strServiceShortName, FilterAction) = DLL("RstrtMgr.dll", "dword RmAddFilter(dword, char*, void*, char*, int)")
# 呼び出し: RmAddFilter(dwSessionHandle, strModuleName, pProcess, strServiceShortName, FilterAction)
# dwSessionHandle : DWORD -> "dword"
# strModuleName : LPCWSTR optional -> "char*"
# pProcess : RM_UNIQUE_PROCESS* optional -> "void*"
# strServiceShortName : LPCWSTR optional -> "char*"
# FilterAction : RM_FILTER_ACTION -> "int"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。