次の方法で共有


AbortSystemShutdownA 関数 (winreg.h)

開始されたシステムシャットダウンを停止します。

構文

BOOL AbortSystemShutdownA(
  [in, optional] LPSTR lpMachineName
);

パラメーター

[in, optional] lpMachineName

シャットダウンを停止するコンピューターのネットワーク名。 lpMachineName が NULL または空の文字列 場合、関数はローカル コンピューターのシャットダウンを停止します。

戻り値

関数が成功した場合、戻り値は 0 以外です。

関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

InitiateSystemShutdown および InitiateSystemShutdownEx 関数には、システムがシャットダウンしていることをユーザーに通知するダイアログ ボックスが表示されます。 シャットダウン タイムアウト期間中、AbortSystemShutdown 関数は、システムのシャットダウンを妨げる可能性があります。

Windows Server 2003 および Windows XP sp1: シャットダウンするコンピューターがターミナル サービス サーバーの場合、システムは、シャットダウンが開始されたことを警告するすべてのローカルおよびリモート ユーザーにダイアログ ボックスを表示します。 AbortSystemShutdownシャットダウンできない場合は、サーバーがシャットダウンされなくなったことをユーザーに通知するダイアログ ボックスが表示されます。

ローカル コンピューターのシャットダウンを停止するには、呼び出し元のプロセスにSE_SHUTDOWN_NAME特権が必要です。 リモート コンピューターのシャットダウンを停止するには、呼び出し元のプロセスにリモート コンピューターに対するSE_REMOTE_SHUTDOWN_NAME特権が必要です。 既定では、ユーザーはログオンしているコンピューターでSE_SHUTDOWN_NAME特権を有効にでき、管理者はリモート コンピューターでSE_REMOTE_SHUTDOWN_NAME特権を有効にすることができます。 詳細については、「特別な特権を使用した実行 」を参照してください。

エラーの一般的な理由としては、無効なコンピューター名、アクセスできないコンピューター、権限が不足しているなどがあります。

例については、「シャットダウン ダイアログ ボックスを表示する」を参照してください。

手記

winreg.h ヘッダーは、AbortSystemShutdown を、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winreg.h (Windows.h を含む)
ライブラリ Advapi32.lib
DLL Advapi32.dll

関連項目

InitiateSystemShutdown の

シャットダウン

システムシャットダウン機能