<Return[S]><Top>

SetupRenameError

Declare Function Api_SetupRenameError& Lib "setupapi" Alias "SetupRenameErrorA" (ByVal hwndParent&, ByVal DialogTitle$, ByVal SourceFile$, ByVal TargetFile$, ByVal Win32ErrorCode&, ByVal Style&)

Declare Function SetupRenameError Lib "setupapi" Alias "SetupRenameErrorA" (ByVal hwndParent As Long, ByVal DialogTitle As String, ByVal SourceFile As String, ByVal TargetFile As String, ByVal Win32ErrorCode As Long, ByVal Style As Long) As Long

ファイルの名前変更エラーをユーザーへ通知するためのダイアログボックスを生成する。

パラメータ
hwndParent
    このダイアログボックスの親ウィンドウのハンドルを指定する。
DialogTitle
    エラーダイアログボックスのタイトルを表す NULL で終わる文字列へのポインタを指定する。

    このパラメータはオプションであり、NULL の場合、既定のタイトルである "Rename Error" が使われる(システムの言語に合わせてロー

    カライズ表示される)。
SourceFile
    操作に失敗したソースファイル(セットアップ元)の完全パスを表す、NULL で終わる文字列へのポインタを指定する。
TargetFile
    操作に失敗したターゲットファイル(セットアップ先)の完全パスを表す、NULL で終わる文字列へのポインタを指定する。
Win32ErrorCode
    ファイル操作の最中に発生した Win32 のエラーコードである。
Style
    ダイアログボックスの表示形式と動作を制御するフラグを指定する。次のいずれかの値を指定できる。

    値                                  

意味                                                                                                                                     

    IDF_NOBEEP

 

通常、このダイアログボックスは最初に表示されたときにユーザーの注意を引くためにビープ音を発生させるが、

このビープ音を抑制する。

    IDF_NOFOREGROUND

 

通常、このダイアログボックスはフォアグラウンド(モーダル)ウィンドウとして表示されるが、このような方法に

よる表示を抑制する。


戻り値
    この関数は、次のいずれかの値を返す。

    値                                             

意味                                                                               

    DPROMPT_SUCCESS

ユーザーは操作を再試行し、操作に成功した。

    DPROMPT_CANCEL

ユーザーは[Cancel](キャンセル)ボタンをクリックした。

    DPROMPT_SKIPFILE

ユーザーは[Skip File](スキップ)ボタンをクリックした。

    DPROMPT_OUTOFMEMORY

メモリ不足で、要求を処理できない。