FindExecutable

The FindExecutable function retrieves the name and handle to the executable (.EXE) file associated with the specified filename.

HINSTANCE FindExecutable(

LPCTSTR lpFile, // pointer to string for filename
LPCTSTR lpDirectory, // pointer to string for default directory
LPTSTR lpResult // pointer to buffer for string for executable file on return
);  

Parameters

lpFile

Pointer to a null-terminated string specifying a filename. This can be a document or executable file.

lpDirectory

Pointer to a null-terminated string specifying the default directory.

lpResult

Pointer to a buffer to receive the filename when the function returns. This filename is a null-terminated string specifying the executable file started when an "open" association is run on the file specified in the lpFile parameter.

Return Values

If the function succeeds, the return value is greater than 32.

If the function fails, the return value is less than or equal to 32. The following table lists the possible error values:

Value Meaning
0 The system is out of memory or resources.
31 There is no association for the specified file type.
ERROR_FILE_NOT_FOUND The specified file was not found.
ERROR_PATH_NOT_FOUND The specified path was not found.
ERROR_BAD_FORMAT The .EXE file is invalid (non-Win32 .EXE or error in .EXE image).

Remarks

When FindExecutable returns, the lpResult parameter may contain the path to the DDE server started if no server responds to a request to initiate a DDE conversation.

See Also

ShellExecute