ShutdownBlockReasonCreate

システムをシャットダウンできないことを示し、システムシャットダウンが開始された場合にユーザに表示する理由文字列を設定する。

ShutdownBlockReasonCreate hWnd, pwszReason

hWnd : [intptr] アプリケーションのメインウィンドウへのハンドル。
pwszReason : [wstr] アプリケーションがシステムシャットダウンをブロックしなければならない理由。

(プラグイン / モジュール : user32.dll)

解説

システムをシャットダウンできないことを示し、システムシャットダウンが開始された場合にユーザに表示する理由文字列を設定する。

[戻り値]
成功した場合、戻り値は 0 以外。失敗した場合、戻り値は 0。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
この関数は hWnd を作成したスレッドからのみ呼び出せる。そうでなければ失敗し、最後のエラーは ERROR_ACCESS_DENIED
となる。中断できない操作(CD/DVD の書き込みなど)を開始するときに呼び出すべきである。

情報

プラグイン / モジュールuser32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の user32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_user32_gen2.hs