<Return[S]><Top>

SetupPromptReboot

Declare Function Api_SetupPromptReboot& Lib "setupapi" Alias "SetupPromptReboot" (ByRef FileQueue&, ByVal Owner&, ByVal ScanOnly&)

Declare Function Api_SetupPromptReboot& Lib "setupapi" Alias "SetupPromptReboot" (ByRef FileQueue&, ByVal Owner&, ByVal ScanOnly&)

システムを再起動するかどうかをユーザーに尋ねる。

パラメータ
FileQueue
    シャットダウンが必要かどうかという決定を下すための基準を提供するファイルキューのハンドルを指定する。

    このパラメータはオプションであり、指定されていない場合、この関数はシャットダウンが必要であることを想定し、再起動するかどうかをユー

    ザーに尋ねる。
Owner
    この関数が作成するウィンドウを所有する、親ウィンドウのハンドルを指定する。
ScanOnly
    この関数を呼び出したときにユーザーへのプロンプトを表示するかどうかを指定する。
    このパラメータはオプションであり、このパラメータが TRUE の場合、再起動するかどうかをユーザーに尋ねることはなく、システムのシャット

    ダウンも開始しない。この場合、FileQueue パラメータを指定しなければならない。

    一方、FALSE の場合、前述のとおり再起動するかどうかをユーザーに尋ねる。
    実際にシャットダウンを開始する前に、シャットダウンが必要かどうかを決定したい場合は、このパラメータを使う。
　

戻り値
    この関数は、次のフラグの組み合わせを返す。エラーが発生した場合は、-1 が返る。

    値                                                       

意味                                                                                                                 

    SPFILEQ_FILE_IN_USE

キューコミットのプロセスの際に、少なくとも 1 つのファイルが使用中だったので、保留されてい

る遅延ファイル操作が存在する。FileQueue パラメータが指定された場合にのみ、このフラグが

セットされる可能性がある。

    SPFILEQ_REBOOT_RECOMMENDED

システムを再起動するべきである。その他のフラグや、シャットダウンするかどうかの質問に対す

るユーザーの応答によっては、シャットダウンがすでに開始されている可能性もある。

    SPFILEQ_REBOOT_IN_PROGRESS

システムのシャットダウンが進行中である。

    拡張エラー情報を取得するには、GetLastError 関数を使う。