Win32 API 日本語リファレンス
ホームNetworking.Clustering › ResUtilVerifyShutdownSafe

ResUtilVerifyShutdownSafe

関数
ノードのシャットダウンが安全か検証する。
DLLRESUTILS.dll呼出規約winapi

シグネチャ

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

DWORD ResUtilVerifyShutdownSafe(
    DWORD flags,
    DWORD reason,
    DWORD* pResult
);

パラメーター

名前方向
flagsDWORDin
reasonDWORDin
pResultDWORD*out

戻り値の型: DWORD

各言語での呼び出し定義

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

DWORD ResUtilVerifyShutdownSafe(
    DWORD flags,
    DWORD reason,
    DWORD* pResult
);
[DllImport("RESUTILS.dll", ExactSpelling = true)]
static extern uint ResUtilVerifyShutdownSafe(
    uint flags,   // DWORD
    uint reason,   // DWORD
    out uint pResult   // DWORD* out
);
<DllImport("RESUTILS.dll", ExactSpelling:=True)>
Public Shared Function ResUtilVerifyShutdownSafe(
    flags As UInteger,   ' DWORD
    reason As UInteger,   ' DWORD
    <Out> ByRef pResult As UInteger   ' DWORD* out
) As UInteger
End Function
' flags : DWORD
' reason : DWORD
' pResult : DWORD* out
Declare PtrSafe Function ResUtilVerifyShutdownSafe Lib "resutils" ( _
    ByVal flags As Long, _
    ByVal reason As Long, _
    ByRef pResult As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

ResUtilVerifyShutdownSafe = ctypes.windll.resutils.ResUtilVerifyShutdownSafe
ResUtilVerifyShutdownSafe.restype = wintypes.DWORD
ResUtilVerifyShutdownSafe.argtypes = [
    wintypes.DWORD,  # flags : DWORD
    wintypes.DWORD,  # reason : DWORD
    ctypes.POINTER(wintypes.DWORD),  # pResult : DWORD* out
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('RESUTILS.dll')
ResUtilVerifyShutdownSafe = Fiddle::Function.new(
  lib['ResUtilVerifyShutdownSafe'],
  [
    -Fiddle::TYPE_INT,  # flags : DWORD
    -Fiddle::TYPE_INT,  # reason : DWORD
    Fiddle::TYPE_VOIDP,  # pResult : DWORD* out
  ],
  -Fiddle::TYPE_INT)
#[link(name = "resutils")]
extern "system" {
    fn ResUtilVerifyShutdownSafe(
        flags: u32,  // DWORD
        reason: u32,  // DWORD
        pResult: *mut u32  // DWORD* out
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("RESUTILS.dll")]
public static extern uint ResUtilVerifyShutdownSafe(uint flags, uint reason, out uint pResult);
"@
$api = Add-Type -MemberDefinition $sig -Name 'RESUTILS_ResUtilVerifyShutdownSafe' -Namespace Win32 -PassThru
# $api::ResUtilVerifyShutdownSafe(flags, reason, pResult)
#uselib "RESUTILS.dll"
#func global ResUtilVerifyShutdownSafe "ResUtilVerifyShutdownSafe" sptr, sptr, sptr
; ResUtilVerifyShutdownSafe flags, reason, varptr(pResult)   ; 戻り値は stat
; flags : DWORD -> "sptr"
; reason : DWORD -> "sptr"
; pResult : DWORD* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "RESUTILS.dll"
#cfunc global ResUtilVerifyShutdownSafe "ResUtilVerifyShutdownSafe" int, int, var
; res = ResUtilVerifyShutdownSafe(flags, reason, pResult)
; flags : DWORD -> "int"
; reason : DWORD -> "int"
; pResult : DWORD* out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; DWORD ResUtilVerifyShutdownSafe(DWORD flags, DWORD reason, DWORD* pResult)
#uselib "RESUTILS.dll"
#cfunc global ResUtilVerifyShutdownSafe "ResUtilVerifyShutdownSafe" int, int, var
; res = ResUtilVerifyShutdownSafe(flags, reason, pResult)
; flags : DWORD -> "int"
; reason : DWORD -> "int"
; pResult : DWORD* out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	resutils = windows.NewLazySystemDLL("RESUTILS.dll")
	procResUtilVerifyShutdownSafe = resutils.NewProc("ResUtilVerifyShutdownSafe")
)

// flags (DWORD), reason (DWORD), pResult (DWORD* out)
r1, _, err := procResUtilVerifyShutdownSafe.Call(
	uintptr(flags),
	uintptr(reason),
	uintptr(pResult),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD
function ResUtilVerifyShutdownSafe(
  flags: DWORD;   // DWORD
  reason: DWORD;   // DWORD
  pResult: Pointer   // DWORD* out
): DWORD; stdcall;
  external 'RESUTILS.dll' name 'ResUtilVerifyShutdownSafe';
result := DllCall("RESUTILS\ResUtilVerifyShutdownSafe"
    , "UInt", flags   ; DWORD
    , "UInt", reason   ; DWORD
    , "Ptr", pResult   ; DWORD* out
    , "UInt")   ; return: DWORD
●ResUtilVerifyShutdownSafe(flags, reason, pResult) = DLL("RESUTILS.dll", "dword ResUtilVerifyShutdownSafe(dword, dword, void*)")
# 呼び出し: ResUtilVerifyShutdownSafe(flags, reason, pResult)
# flags : DWORD -> "dword"
# reason : DWORD -> "dword"
# pResult : DWORD* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。