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