プラットフォーム SDK
FindExecutable

指定されたファイル名に関連付けられている実行可能（.EXE）ファイルの名前とハンドルを取得します。

HINSTANCE FindExecutable(
  LPCTSTR lpFile,       // ファイル名文字列へのポインタ
  LPCTSTR lpDirectory,  // 既定ディレクトリ文字列へのポインタ
  LPTSTR lpResult       // 返される実行可能ファイル文字列を
                        // 保持するバッファへのポインタ
);

パラメータ

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 サーバーへのパスを保持することがあります。

対応情報

  Windows NT/2000：Windows NT 3.1 以降を使います。
  Windows 95/98：Windows 95 以降を使います。
  Windows CE：対応していません。
  ヘッダーファイル：shellapi.h 内で宣言されています。
  インポートライブラリ：shell32.lib を使います。

参照

ShellExecute

Page view tracker