FindExecutable

Функция FindExecutable возвращает имя и дескриптор исполняемого (.ЕХЕ) файла, ассоциированного с указанным файлом.

HINSTANCE FindExecutable (

LPCTSTR lpFile , // указатель на строку с именем файла

LPCTSTR lpDirectory , // указатель на строку с директорией по

// умолчанию

LPTSTR lpResult // указатель на буфер для строки с именем

// возвращаемого .ЕХЕ файла

);

Параметры

lpFile - указатель на завершающуюся нулем строку, определяющую имя файла. Файл может быть либо документом, либо исполняемым файлом.

lpDirectory - указатель на завершающуюся нулем строку, определяющую директорию по умолчанию.

lpResult - указатель на буфер для имени возвращаемого функцией файла. Имя файла представляет собой завершающуюся нулем строку, определяющую исполняемый файл, который запускается при открытии файла, заданного параметром lpFile .

Возвращаемые значения

В случае успеха возвращаемое значение больше 32. В случае неудачи возвращаемое значение меньше или равно 32. В следующей таблице приведены возможные ошибочные значения:

Значение

Пояснение

Недостаток памяти или ресурсов.

Отсутствует ассоциация для данного типа файлов.

ERROR_FILE_NOT_FOUND

Указанный файл не найден.

ERROR_PATH_NOT_FOUND

Указанный путь не найден.

ERROR_BAD_FORMAT

Неверный формат .ЕХЕ файла (не Win32 .EXE или поврежденный файл)

Комментарии

При возвращении параметр lpResult может содержать путь к серверу DDE, запускаемому, если не получен ответ на запрос инициации DDE-диалога.

См . также

ShellExecute .