<Return[F]><Top>

FindExecutable

Declare Function Api_FindExecutable& Lib "shell32" Alias "FindExecutableA" (ByVal lpFile$, ByVal lpDirectory$, ByVal lpResult$)

Declare Function FindExecutable Lib "shell32" Alias "FindExecutableA" (ByVal lpFile As String, ByVal lpDirectory As String, ByVal lpResult As String) As Long

パラメータ
lpFile
    ファイル名を指定する、NULL で終わる文字列へのポインタを指定する。文書ファイルと実行可能ファイルのどちらでも指定できる。
lpDirectory
    既定のディレクトリを指定する、NULL で終わる文字列へのポインタを指定する。

    NULL または空文字列("")を指定すると、このパラメータは無視される。

    有効な相対パスまたは絶対パスを指定すると、lpFile パラメータのパスがこのパラメータとして決定されることなく、現在の作業ディレクトリ

    が設定される。
lpResult
    関数が制御を返したときにファイル名を受け取るバッファへのポインタを指定する。

    ファイル名は、実行可能ファイルを指定する、NULL で終わる文字列である。

    この実行ファイルは、lpFile パラメータで指定されたファイルを選択したときに、「ファイルを開く」の関連付けに基づいて起動するも。

    このバッファは、MAX_PATH 文字を格納できるだけのサイズを持っていなければならない。


戻り値
    関数が成功すると、32 を上回る値が返る。
    関数が失敗すると、32 以下の値が返る。次の表に、考えられるエラー値を示す。

    値                                              意味                                                                                                                               
    0 システムは、メモリまたはリソースを使い果した。
    31 指定されたファイルタイプに対応する関連付けが存在しない。
    ERROR_FILE_NOT_FOUND 指定されたファイルが見つからなかった。
    ERROR_PATH_NOT_FOUND 指定されたパスが見つからなかった。
    ERROR_BAD_FORMAT .EXE ファイルが無効である(Win32 の .EXE ではないか、.EXE イメージ内にエラーが存在する)。


解説
    DDE の対話を開始するための要求にどのサーバーも応答しなかった場合、FindExecutable 関数が制御を返したときに、lpResult パラメー

    タは起動済みの DDE サーバーへのパスを保持することがある。