FindExecutableW 関数 (shellapi.h)

特定のドキュメント ファイルに関連付けられている実行可能ファイル (.exe) の名前とハンドルを取得します。

構文

HINSTANCE FindExecutableW(
  [in]           LPCWSTR lpFile,
  [in, optional] LPCWSTR lpDirectory,
  [out]          LPWSTR  lpResult
);

パラメーター

[in] lpFile

種類: LPCTSTR

ファイル名を指定する null で終わる文字列のアドレス。 このファイルはドキュメントである必要があります。

[in, optional] lpDirectory

種類: LPCTSTR

既定のディレクトリを指定する null で終わる文字列のアドレス。 この値には NULL を指定できます。

[out] lpResult

種類: LPTSTR

関連付けられている実行可能ファイルのファイル名を受け取るバッファーのアドレス。 このファイル名は、lpFile パラメーターで指定されたファイルに対して関連付けによって "開く" が実行されたときに開始される実行可能ファイルを指定する null で終わる文字列です。 簡単に言うと、これは、ドキュメント ファイルが直接ダブルクリックされたとき、またはファイルのショートカット メニューから [開く ] が選択されたときに起動されるアプリケーションです。 このパラメーターには有効な null 以外の値を含める必要があり、長さは MAX_PATHであると見なされます。 値を検証する責任はプログラマに任されています。

戻り値

種類: HINSTANCE

成功した場合は 32 より大きい値、またはエラーを表す 32 以下の値を返します。

次の表に、考えられるエラー値を示します。

注釈

ドキュメントには FindExecutable を使用します。 実行可能ファイルのパスを取得する場合は、次のコマンドを使用します。

AssocQueryString(ASSOCF_OPEN_BYEXENAME,
                 ASSOCSTR_EXECUTABLE,
                 pszExecutableName,
                 NULL,
                 pszPath,
                 pcchOut);

ここで、pszExecutableName は実行可能ファイルの名前を指定する null で終わる文字列へのポインターであり、pszPath は実行可能ファイルへのパスを受け取る null で終わる文字列バッファーへのポインターであり、pcchOut は pszPath バッファー内の文字数を指定する DWORD へのポインターです。 関数が戻ると、 pcchOut はバッファーに実際に配置された文字数に設定されます。 詳細については、「 AssocQueryString 」を参照してください。

FindExecutable から戻るときに、サーバーが DDE クライアント アプリケーションとの DDE 会話を開始する要求に応答しない場合、lpResult パラメーターには、開始された動的データ交換 (DDE) サーバーへのパスが含まれる場合があります。

要件

こちらもご覧ください

ShellExecute